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SouNb (GxclubiNq IBM veRSioN). TDey fouNb tDat tDe PnoquaM iNCIubes XTeN CDalleNQiNQ 
Quests. TDey also biscoveueb tl)at aw adbitioNal Quest Disk wit») 1 6 Quests is Available. 
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Caub iNfORMatioN to OMNitReNb SoftwaRe, Inc., PC Box 733, West SiMSbuRy, cr 06092. 
PalabiN is $39.95, tbe Quest bisk is $24.95- Please abb $3.00 fOR Postage aNb HaNbliNq. 
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EDITORIAL 




While 



everyone was 
freaking out, 1 
iieard screams 
of ^^Quicic, get 
me a fire 
extinguisiier ! 
and ^^Get 
this on film!^^ 



BOOM! 

That's what it sounded like. Actually 
there was a nice shower of sparks and 
so much smoke it sent the pho- 
tographer and staff running for cover. 
What I'm describing here is my SC1224 
color monitor picking a most inoppor- 
tune time to not only go on the IWtz, but 
to do it in true 50's science Action movie 
style. But let me regress a little here. 

This is the city, Lxjs Angeles, Califor- 
nia. Over 465 square miles of constant- 
ly interfacing humanity representing 
computer users of every creed. . . .It 
was the morning of April 21st. I was 
busy in my downtown office when I 
received a call. They needed my ST to 
shoot the crystal ball inset for the cover 
of this issue. I didn't have the time to 
head down to Culver City, the location 
of the studio, so I asked ST-Log's art 
director Ed Herch whether he and the 
photographer could come in and take 
the photos at the Beverly Hills location. 

After attempting several trial shots, 
the lighting just couldn't be adjusted 
properly, so we headed over to the pho- 
to studio. Oh, I forgot to mention, it was 
one of those rare days in Southern 
California when it was raining. 

We arrived at the studio with my 1040 
and monitor. A^Tiile our photographer, 
Ladi Von Jansky, was positioning the 
camera and lighting, I proceeded to set 
up my equipment. But. . .when I 
pressed the power button on my moni- 
tor, it was Fourth of July time! While 
everyone was freaking out, I heard 
screams of "Quick, get a fire extinguish- 
er!" and "Get this on film!" 

So then someone asked if it's sup- 
posed to do that. My response was, 
"What do you think this is, a PC clone?" 



Another recommended I try it again. 
What the hell. I turned it on again. This 
time just some crackling and buzzing 
sounds. So what happened? Did the rain 
get at it? (It wasn't raining when I car- 
ried it into the studio.) Was it plugged 
accidentally into 220V? (We checked, 
and it wasn't.) Was it the ride down in 
my rental car through the trials and 
tribulations of LA traffic? (Could be!) 

Well, I had a couple of spare monitors. 
Trouble was, they were home. So some- 
one asked "Why not go home and get 
one. . .?" Fine. No problem. "I live in 
Massachusetts! " was my answer to that. 
"Fine! We'll wait for ya." Well, I called 
The Federated Group, which is run by 
Jack Tremiel's son, Gary. As you may 
recall, this chain numbers nearly 70 
stores, and is fairly big throughout the 
west and parts of the midwest. They car- 
ry consumer electronics products such 
as televisions, audio components and 
computers. The chain was purchased by 
Atari last fall. 

Gary was only too happy to help, and 
set me up with a monitor from their 
nearby Federated store on Olympic and 
Bundy (being new to LA, I knew where 
Olympic was— I had gotten lost around 
there a couple times . . . but never heard 
of Bundy) ST-Log Art Director Ed Herch 
and I showed up at the store, with the 
manager expecting us. He quickly 
loaned us a store demo 1224, and we 
went on our way. 

We set the monitor up, turned it on 
(carefully!) and shot the photo. All that 
time and effort— just for that little crys- 
tal ball on the cover! Gee ... I can hard- 
ly wait 'till next month. 

— Lee H. Pappas 
Publisher/ST-Log 
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language wizard, Charles Johnson. 
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A SINGLE ISSUE 

•Let us know your new 
address right away. Attach 
an old mailing label in 
the space provided below 
and print your new 
address where indicated. 
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READER 

COMMENT 



The Great ST Split 

I'm a subscriber to Delphi, and I 
spend the majority of my on-line time 
in the ANALOG Atari SIG. It's been 
many months since the possibility of 
ST users having their own SIG was dis- 
cussed, and still nothing has been 
done. The databases in the ANALOG 
SIG are greatly overcrowded due to the 
fact that programs for both 8- and 
16-bit machines are vying for space 
there, and when I go to read messages 
in the forum, I don't want to be 
bothered with any messages except 
those that relate to my machine. 

Certainly there are enough ST own- 
ers around to support their own SIG. 
(Judging by the messages in the forum, 
90% are ST users already.) What's the 
holdup? We ST owners demand equal 
representation on Delphi! 

—Mark Penfleld 
Atlanta, Georgia 

It's already been done! ST users now 
have their own SIG on Delphi, spon- 
sored of course by ST-Log Magazine. At 
the time of this writing, you could ac- 
cess the new ST SIG by entering the old 
ANALOG SIG and typing ST at the 
ANALOG > prompt. By the time you 
read this, though, the SIG may have 
gotten its own entry on the main sys- 
tem menu. (There was another entry 
there that started with "ST," and it's 
Delphi's policy to keep the menu en- 
tries as unambiguous as possible.) 

The new ST SIG functions exactly the 
same as the ANALOG SIG, so you won 't 
have to learn anything new to take ad- 
vantage of its services. Though all the 



What^s the 
holdup? We 
ST owners 
demand equal 
representation 
on Delphi! 

ST related files have been moved to the 
new SIG, there are some new database 
sections that weren 't available in the 
ANALOG SIG (for instance. Desktop 
Publishing); so you may have to spend 
a little extra time figuring out what files 
got moved where. But in the long run 
having the extra database sections will 
greatly reduce the time it takes to lo- 
cate a particular file, since the database 
sections are now more specific. See you 
on-line! 

The Color of Things to Come 

I have a 520ST with a monochrome 
monitor. I have a friend who has only 
a color monitor. We both read ST-Log 
regularly and both have a very similar 
complaint. Many of your programs run 
on either color systems or 
monochrome systems, but not both. 
It'd be nice if you could only publish 
programs that run properly on both 



systems. That way, nobody has to miss 
out on a great program. For instance, 
I have to go over to my friend's house 
if I want to play "Grin's Castle" or 
"Strathello" from your May issue. 

—Tom Reddy 
Alton, Illinois 

It's not untypical for game software 
to run only on color systems, since 
color can be very important to game 
graphics. And since the May issue had 
an adventure theme, it concentrated 
on games. 

However, there's more to consider 
than what type of software a program 
is. A magazine like ST-Log relies on its 
freelance contributors for the bulk of 
the material published. Frequently, 
these contributors do not own both a 
color and monochrome system, so 
can 't develop their programs to work 
on both. ST-Log's programmers simply 
don 't have the time to rewrite each pro- 
gram we choose to publish so that it's 
compatible with all systems, and we 
don 't like to turn away a good program 
simply because it 's limited to one type 
of system. We try very hard to please 
everybody— and it is certainly true that 
a program that runs on all systems has 
a better chance of being accepted for 
publication than one that has a more 
limited audience— but sometimes we 
must rely on our Judgement and pub- 
lish programs that we feel are excep- 
tional enough to merit attention, even 
if they won 't be usable by every reader. 

All the programs in the April issue 
ran on both color and monochrome 
systems. The June issue contained two 
programs for all systems (ST Font 
Printer and Mouse-ka-source) and one 
each for color or monochrome only 
(Decimal Destroyer and BASIC Draw, 
respectively). This issue contains only 
one program, Moonlord ST, that is 
limited to one system type. 

The Support Dilemma 

I am the owner of both an IBM PC 
and a 520ST, and I am continually 
amazed at the differences in the serv- 
ice offered by companies who provide 
software or hardware for these 
machines. I'm not even talking about 
factory service for the machines, which 
IBM has built its reputation upon. I'm 
just talking about a simple phone call 
to a software vendor. I've never had 
any trouble getting help with the 
products I've purchased for my IBM. If 
I have trouble with a software package, 
in most cases a quick phone call will 
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In most cases, a telephone call to the 
software vendor will result in a conversation 
with someone who hasn^t the vaguest idea. 



bring me a solution. 

Not so with ST software. In most 
cases, a telephone call to the software 
vendor will result in a conversation 
with someone who l^asn't even the 
vaguest idea of what he's doing. Letters 
usually go unanswered. I've discovered 
that when one buys a piece of ST soft- 
ware, he's almost certainly on his own. 
There have been exceptions: most nota- 
bly WordPerfect Corporation's incredi- 
ble customer-service department. 
These people stay in touch with their 
users. You don't have to beg for up- 
grade information or answers to 
questions. 

I don't see why all providers of ST 
software can't treat their customers 
with the same kind of support Word- 
Perfect offers. It seems to be that it 
would pay off in the long run. 

—Anthony Pellman 
Spokane, Washington 



You're not alone in your complaints, 
and though there is no good excuse for 
a company to ignore its customers, 
there are some reasons why you ex- 
perience better product support for 
IBM programs than for ST ones. 

It all comes down to numbers. Cus- 
tomer support is an expensive and 
time-consuming task. Many publishers 
of ST software have only a few people 
on their staff, each person having to 
wear many different "hats" during the 
course of a day. This means that the 
staffs time is spread very thinly over 
a variety of tasks that must be complet- 
ed to run a company. Since ST software 
doesn 't sell anywhere near the number 
of packages an equivalent IBM product 
would, these ST software companies 
frequently can 't afford a larger staff 

Your experience with WordPerfect 
Corporation proves the point. WordPer- 
fect is a very large company that al- 



ready had a good customer-support sys- 
tem in place before they released their 
word processor for the ST. For that rea- 
son, ST users get the benefit of a 
customer-support department that is, 
at this point, really being paid for by 
the users of other machines. The more 
popular the ST becomes, the more soft- 
ware will be sold, and the larger and 
more organized the software compa- 
nies will become. Until then ST soft- 
ware purchasers will undoubtedly no- 
tice a lesser quality of customer 
support. 

However, as we stated above, there is 
no good excuse for a software compa- 
ny to ignore its customers. ST software 
suppliers should note that their cus- 
tomers want and need their help. If 
anybody reading this is a software sup- 
plier not willing to support his product, 
ST-Log suggests you find a new line of 
work. 



PrOCODV BACKUP 

■^^ UTILITY 

You can't backup your software 
because copy protection locks 
you out. ProCopy is ttie key! 

■ Protects against the accidental loss of 
expensive software 

■ Works witti all Atari STs 

■ Copies both! S/S & D/S disl<s 

■ Use witti 1 or 2 clisl< drives 

■ Not copy protected 

■ FREE stripping and tiandling 

■ TOLL-FREE teleptione number 

■ Updates available to registered owners 

■ Orders stiipped same day 

■ Disl< analyze function included 
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$ 34-95 



Cgll (800) 843-1223 

Send check for S34.95 (overseas add S2.00 for air mail) to: 

PROCO PRODUCTS 

P.O. BOX 665, CHEPACHET, RHODE ISLAND 02814 USA 
(401) 568-8459 



Available the moving finger go. 
in Europe Building 2 

Shamroci( Quay 
Southampton, S01-1QL 
England 
Tel. 0703-229041 



TECH-SOFT 
COrVlPUTER WHOLESALE 
324 Stirling Highway 
Claremont 
Western Australia 6010 
Tel. 09-385-1885 
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An inaudible simulation 

Caidiac Anest! 




with binder and manual, $69. 
See discounted package price. 

Cardiac Arrest! is a unique product. In this mathematicaUy- 
based simulator, you interpret the history, on-screen EKG, lab 
data, and vital signs, then give treatment orders in plain 
English. While many computer users enjoy Cardiac Arrest! as 
a challenging medical adventure game, ifs a sophisticated 
product used world-wide for ACLS (Advanced Cardiac Life 
Support) education. IBM, Apple II -I- /c/e. Atari ST, Atari XUE. 
Antic "impieasive and amazingly complete" 
ST World: "both highly educational and fun to play" 

We support our products. Updates will be available to users for 
$6 eadi when ACLS recommendations change. Our software is 
NOT copy-protected. 

Cardiac Arrest! $69 

ACLS Protocols $29 

EKG Teaching $29 

CaniioQuiz $19 

Blood Gases $24 

QuizPlus $29 

Demo $7 

Ask about the four-disk ACLS Package (includes Cardiac Arrest!) 

for $109. Order direct! 

Mad Scientist Software 

2063 N. 820 W., Pleasant Grove, UT 84062 
Visa/MC oideis call 801-785-3028 
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ST Babylon 

Did you ever think that Hollywood 
stars such as Bob Hope, Sophia Loren, 
and Frank Sinatra use Atari ST com- 
puters? Well, Merrill Ward Software 
has indirectly brought these stars to 
the ST with their new product. The 
Celebrity Cookbook. The product is 
nicely packaged in what would look 
like a small cookbook and includes 
over 300 recipes that originated by the 
likes of Shirley Maclaine, Ronald Rea- 
gan and others. 

After you get over the "hype" of the 
packaging, you will find a pretty decent 
assortment of recipes that can be made 
in just about any kitchen. Instead of 
favoring the more technically difficult 
dishes, The Celebrity Cookbook offers 
a common-sense approach to making 
breakfast, lunch and dinner. 

The Celebrity Cookbook comes in six 
separate volumes. Each volume covers a 
different topic: Holiday cooking, weight- 
watching meals, nutrition, buying food, 
etc. The program runs on "any" ST, 
although we only tested it on a 520ST. 

Merrill Ward Software 

255 N. El Cielo Road, Suite 222 
Palm Springs, CA 92262 
(619) 320-5828 



Atari Fun For Little Tots! 

A new series of educational programs 
is being produced by Alohafonts Soft- 
ware. Uncle D's Con-Sound-Tration 
game tests and enhances memory con- 
centration techniques for children four 
and up. The product comes with two 
disks, a general program disk and a 
data disk. Once the program has been 
loaded, everything is icon driven, so 
children will find it easy to work with 
once they get used to manipulating the 
mouse. 

Uncle D is a cute character who ap- 
pears to indicate the success or failure 
of a child to solve one of the puzzles. 
In play, the child selects a square from 
the screen and is shown a drawing of 
an everyday object. The child then flips 
a square from the right side of the 
screen and hears a digitized recording 
of the object's sound. If the child 
matches the drawing to the sound, the 
objects disappear and a happy face of 
Uncle D appears. Otherwise, the 
squares are flipped back over and the 
game continues. 

Con-Sound-Tration has a list price of 
only $24.95 and comes with four sets 
of games. Also available are several data 
disks that explore the environment, 
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Spanish / French / German languages, 
and more. 

AlohaFonts 

PO Box 2661 

Fair Oaks, CA 95628-2661 

Typing With Mavis Wlio? 

Mavis Beacon is just like the woman 
that might have tried to teach you typ- 
ing skills when you were in high 
school. She is a good teacher, she puts 
on the pressure if you don't work hard 
enough and rewards you with some 
fun if you do well. This might not 
sound like your typical typing-tutor 
program, but Mavis Beacon Teaches 
Typing isn't your normal teacher. 

Split between your normal class- 
room typing sessions and an interest- 
ing road racing game. Mavis has three 
levels of teaching: Never seen a type- 
writer. Somewhat Good, and Expert. 
Once selected. Mavis adjusts the 
difficulty according to how you 
progress through the 50 or so lessons. 
The program is completely icon/menu 
driven, so it is suitable for children 
learning how to type. 

Mavis Beacon Teaches Typing is nice- 
ly packaged with a complete user manu- 
al and supplement for the Atari ST. 



Software Toolworlcs 

One Toolworks Plaza 
13557 Ventura Blvd 
Sherman Oaks, CA 91423 
(818) 907-6789 

Datasoft Adds Some Fun 

Datasoft has released three new 
games for the ST: Battledroidz, Global 
Commander, and The Rubicon Alli- 
ance. The games feature good graphics 
and animation and all are priced under 
$30. 

BattleDroidz is a combination of Mar- 
ble Madness and Tron, two popular ar- 
cade games. Ajoystick is used to move 
your character around a three- 
dimensionally drawn screen. Hills, 
ramps, canyons and cliffs make up the 
playfield that is inhabited with 
Cyborltes, little pill-shaped creatures 
that try to zap you. A game-grid map 
shows your movement through the 
playfield until you complete each lev- 
el. If you were disappointed by the ST 
version of Marble Madness, you might 
And this one a challenge. 

In Global Commander you must care- 
fully negotiate peace between the 
Earth's United Nuclear Nations (UNN). 
The program is icon driven and gives 
you information about the UNN econ- 
omies, resources, food supplies, etc. 
There are 16 UNN world powers that 
are nuclear-armed and aggressive. The 
goal of the game is to avoid nuclear war 
and save the world. 

The Rubicon Alliance is a shoot-'em- 
up game where you pilot a starship that 
destroys just about everything in sight. 
Your home planet's defense shield has 
been breached and you must flght off 
the Invaders until you find the pro- 
tagonist of this game, Nono. Eight mis- 
sions must be completed before you 
can attach Nono and save your planet. 

Datasoft (inteilicreations) 

19808 Nordhoff Place 
Chatsworth, CA 91311 
(818) 886-5922 

Wliot is SQL? 

The Structured Query Language 
(SQL) is a new database query system 
that is just now making significant in- 
roads into the mass business market. 
Microsoft, Apple, Lotus, Borland, 
Ashton Tate, and many other top soft- 
ware companies have announced SQL 
products for the IBM PC and Macin- 
tosh. SQL is now the accepted standard 
American database query language. 



The SQL system has been available 
for the ST for the past year in Regent 
Base from Regent Software. The ST 
almost had a second SQL database 
when Oracle (a huge software compa- 
ny that specializes in databases) was 
considering porting its powerful SQL 
database onto the ST to run under 
Whitesmith's Unix system. Unfor- 
tunately, Oracle changed its mind. 

Regent Software has now released 
the Regent Base Guide Book, a 100-page 
introduction to the SQL system as im- 
plemented on the ST in Regent Base. 
The Guide Book also comes with a 
demonstration version of Regent Base 
and all of the tutorial examples. At 
$24.95, the Guide Book is a good in- 
troduction to the SQL language and 
overall database design principles. 

Regent Software 

7131 Owensmouth #45A 
Canoga Park, CA 91303 
(818) 882-2800 

Delphi Maices Changes 

ST/Log's official national bulletin 
board system can be found on Delphi. 
Since ST/Log used to be published as 
part of ANALOG, the ANALOG forum 
has been used to keep 8-Bit and ST in- 
formation, news, and downloads. Un- 
fortunately, this has made the one fo- 
rum very crowded with information of 
both systems. 

Delphi has now enhanced its system 
by adding a new ST Forum. Now you 
will find each month's ST/Log down- 
loads in the new forum, as well as all 
the news, information and questions 
that used to be found in the AN^iLOG 
forum. To access the new forum, type 
GROUPS ST from the main prompt. 

ST Xformer Enhancements 

For those of you that are using Darek 
Mihocka's 8-bit emulator to run Atari 
XL/XE programs on your ST, Darek is 
working on a new version. The new 
version will include new features such 
as Player-Missile graphics support and 
a modem (R:) device handler. The more 
startling news is that the new version 
will also emiolate an Apple II and Com- 
modore 64. 

If all this turns out to be true, the ST 
will be able to run IBM-PC software un- 
der PC-Ditto, Macintosh software under 
the Magic Sac, Apple II, Commodore 64, 
and Atari XL software under the 
Xformer. This just goes to show how 
versatile the ST really is. 
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)0T UP 
G SAVINGS! 




SAVE TIME AND MONEY 
SUBSCRIBE TO ST-LOG 

SAVE $14 OFF THE 
COVER PRICE WITH 
THE CONVENIENCE 
OF HAVING ST-LOG 
DELIVERED DIRECT- 
LY TO YOUR DOOR 
BEFORE IT EVEN HITS 
THE NEWSSTANDS! 
GET THE MOST OUT 
OF YOUR COMPUTER 
SUBSCRIBE TO 
ST'lOe 
TODAY I 



1 YEAR FOR ONLY $28 

SAVE $14 OFF THE COVER PRICE 

1 YEAR WITH DISK ONIY $ 105 



□ 1 YEAR @ $28 — SAVE $14! 
FOREIGN - ADD $7 PER YEAR 

□ 1 YEAR WITH DISK @ $105 
FOREIGN - ADD $15 PER YEAR 

□ PAYMENT ENCLOSED □ BILL ME 
CHARGE MY: □ VISA □ MC # 



••••••••••« 

MCGWW 



DCGWW 



EXPIRATION DATE SIGNATURE 

MONEY BACK ON ALL UNUSED PORTIONS OF SUBSCRIPTIONS IF NOT SATISFIED. 



NAME 



ADDRESS 



CITY 



STATE 



ZIP 



MAKE CHECK PAYABLE TO L.F.P., INC., P.O. Box 16928, N. Hollywood, CA 91615. Offer expires August 
31, 1988. Your first issue will arrive in 6 to 8 weeks. 



WATCH FOR IT! 



HARDWARE ADD-ON's fnr ATARI ciT 



MEMORY upgrades: 

Solderless "plug in" installation, 1 year warranty 

520ST - expand to 1 , 2.5 or 4 MB on ONE board 

- prices start at $129 for the OK version - or go to 

1 MB only, $79 - without ram. 

1040/520STfm - upgrade to 2.5 and 4 MB, fully 

socketed, OK board $149. 

For all our memory upgrades: on board CLOCK 

module only $30 incl. software! 

For more detailed information phone or write to: 



t 



cini=speci« 

1022 Hodgkins, Houston, TX 77032 
(713) 590-2068 and 590-3738 



Co. 



We ship COD or prepaid, sorry no credit cards! 
S/H on memory upgrades $5 
on Hard Drive Kits - $10/no drive - $20/w. dr. 
Texas residents add 8% state sales tax. 

CIRCLE #104 ON READER 



EXPANDABLE 
Hard Drive Kits: 

1. 10" X 6.5" X 15" with full SCSI interface - 150 W 
PC power supply with fan - room for up to 5 half 
height drives - mounts on floor, under desk or on 
desktop - can supply power to 520ST and disk 
drives. 

kit with 40 MB full height 30 ms drive $745 

2. MEGA footprint, 3.7" high, 1-port SCSI Interface 
- room and power for 3 half height or 1 each full 
and half height drive, comes with fan 

kit with 10 MB half height drive $395 

3. 4.5" wide x 6" high x 13" deep with 1 port SCSI 
host adapter - ready for 2 half height or 1 full 
height - 55 W power supply, fan optional 

kit with 20 MB 1/2 height $435 

Atari 520ST, 1040St, 520STfm and MEGA are 
trademarks of ATARI Corp. 

SERVICE CARD. 



WHAT 
CAN 



CgfCIT 



DO FOR YOUR 
BUSINESS? 



CRiciT is an integrated Cash Register & 
Inventory Control package so complete that 
you can give your old cash register notice! CRICIT 
ties together many of the facets of running your 
business. Here's what CRICIT can do for you: 

• Complete cash register functions 

• Flexible inventory control for 65,500 products 

• Daily, period and yearly reporting 

• Price/product labels with optional bar code 

• Coupon issue and redemptlon(fixed or % of sale) 

• Customized receipts, coupons, inventory and 
reporting 

• Ready- to- mail purchase orders with automatic 
re-order calculation 

• Commission calculation for 15 sales clerks 

• Mailing lists in list and label formats 

• Lay-aways, auto- discounts, stock searches 

• Between- store reporting via modem 

• User-friendly error correction and training manual 

$219 U.S. / $299 Can. 

Contact your dealer or 
send check/MO to: 

Nice & Software. Inc. 
103 Queen Street S. 
Kitchener, Ontario 
Canada N2G 1W1 
(519) 744-7380 
Visa & MasterCard 
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Dealer and Distributor Inquiries Welcome 



New from the people who 
brought you IVIonitor IMaster! 




Are you tired of fumbling under or behind 
your computer to swap your mouse and joy- 
stick cables? Are your cable and computer 
connectors worn out from all the plugging and 
unplugging? Then Mouse Master is a must 
for you! 



t 



PfQCtiCQl 

Solution/s 



39.95* 



I930 E. Grant Rcl.. 
Tuc/on. AZ 85719 

*Retail price does not 
include shipping & handling. 



602- 884 9612 



CIRCLE #105 ON READER SERVICE CARD. 



CIRCLE #101 ON READER SERVICE CARD. 




Any 
Resolution 

Dial 

XR 



Multi-tasking tlie ST 

We all have our own dream pro- 
grams. The two main things that I do 
with my ST are writing and BBSing. 
The problem is that BBSs, unlike com- 
mercial systems, are single-user. If 
someone else is on-line, then I have to 
keep re-dialing until the line is free. If 
I use an attack-dialing terminal pro- 
gram, then my computer is tied up. 
Frankly, I have better things to do with 
my time than to watch a screenful of 
"ATDT" lines slowly scrolling by. 

What I need is a program that will al- 
low me to write while simultaneously 
auto-redialing. Connecting with the 
BBS would signal me, and one quick 
point-and-click mouse operation would 
activate the terminal. After I had 
logged-off, a single keystroke would 
return me to my original text screen. 



by Maloney 

My file would be intact— the cursor 
would even still be right where I had 
left it. 

After about a year I realized that no 
one else was going to implement my 
idea; there just isn't a large enough 
market to justify the investment of 
time and money. After all, my dream 
program is not necessarily yours. You 
might want to attack-dial while fore- 
casting with a spreadsheet, plotting 
your bio-rhythm cycle, or whatever. 
Besides that, we're all accustomed to 
using the programs that we already 
have. We don't want the hassle of learn- 
ing new ones to do the same tasks. 

The Power of the GEM Interface 

GEM provides part of the answer for 
us — the ability to access programs as 
desk accessories. Most of these are con- 



venience items like calculators and 
notepads. Others, such as the VT-52 
emulator provided on the ST language 
disk, are much more powerful. Insofar 
as I usually only access message bases, 
I don't often need a terminal with up- 
load/download capability. The emulator 
would normally serve my needs if 
somehow I could make it auto-redlal. 

This is what inspired me to write 
"DIALXR." It functions as a shell, in- 
terfacing between the emulator and the 
operating system to turn the ST into an 
attack-dialing terminal. You can put it 
into the AUTO folder, and its operation 
is completely user-transparent. It is 
compatible with just about any GEM 
program (including the desktop), and 
it will also work (with some adjust- 
ments on your part) with many TOS 
programs. Best of all, it steals less 
than% K of memory. 
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How It Works 



TOS was written to be "programmer 
friendly." By this I mean that its four 
major sections— GEMDOS, GEM, the 
BIOS, and the XBIOS— are accessed in- 
directly through memory vectors 
which point to the addresses at which 
they actually reside. Because these 
"hooks" are located in RAM, a program- 
mer can modify their contents to point 
to custom routines. 

I used this technique to intercept 
characters being sent from the key- 
board to the modem on the RS-232 
port. The BIOS vector is changed to the 
address of a routine which interprets 
keystrokes, setting and resetting flags 
and timers. The address of a second 
routine is placed in the vbl (vertical 
blanking) interrupt queue. This latter 
code is invoked about 60 times per 



second. 



Magic Fingers 

These two routines work together. 
After you enter the ATDT' (or ATDP') 
sequence to dial a number, the system 
waits for 30 seconds. If a connection 
has not been established, then the pro- 
gram forces the modem to disconnect 
from the line. It then waits for two se- 
conds (to let the phone line settle), 
reconnects, and finally the "A/" redial 
command is sent to the modem. The 
BIOS handles this as though you had 
the emulator on-screen and were 
manually typing in the command. 

You can use any Hayes-compatible 
(or semi-compatible) modem connect- 
ed to the RS-232 port. The only require- 
ment is that it accept the "ATD" and 
the "A/" commands. 



So Let's Use It 

If you're not familiar with the VT-52 
emulator, you should check out the 
sections in your ST owner's manual 
about the emulator and changing the 
RS-232 configuration. Chances are that 
the only parameter that you will need 
to change is the baud rate. Be sure to 
save the desktop after doing so. 

Enter and RUN the BASIC loader to 
create the file "DIALXR.PRG" on the 
disk in drive A. (Don't forget to check 
your typing with ST-Check.) Again I 
suggest that you place this file into the 
AUTO folder. Your boot disk will also 
require the emulator .ACC file. 

Boot-up your ST. If your application 
program is GEM-based, then double- 
click on it, and after it is up, load in the 
file with which you will be working (if 
any). Turn on your modem and select 
"VT-52 Emulator" from the "Desk" 
menu. Enter the dialing sequence, and 
then return to your main program by 
pressing the "undo" key. 

When the BBS answers your call the 
bell will sound, and the screen will 
change to reverse video. In about a 
quarter second the bell will again ring, 
and the screen will return to normal. 
Then just select the emulator and log- 
on. That's all there is to it! 

After you log-off press "UNDO" to 
return to your application. You may, of 
course, elect to attack-dial another sys- 
tem before doing so. "DIALXR" is ful- 
ly re-entrant. 

Another option that you have is to ig- 
nore the on-line signal. Insofar as BBS 
programs wUl log you off if they do not 
receive a keystroke within a couple of 
minutes, if you've changed your mind 
about going on-line, you can continue 
with your main program. As an alter- 
native you can switch your modem 
from "Data" to "Voice" or just turn it 
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off. 



A Few Final User Notes 



"DIALXR" plays by the rules of 
TOS, so you should not have compati- 
bility problems with any application 
program— providing that it also follows 
proper programming procedures. Any 
program that insists on stealing the se- 
cond vbl interrupt vector rather 
than searching the queue for a free 
one will incapacitate "DIALXR." 



This also applies to other utilities that 
you might put into the AUTO folder. 
To prevent this problem, copy 
"DIALXR" into the folder last. 

Another possible pitfall could arise if 
your main program intercepts the 
BIOS vector. If the program does not re- 
store the vector when it exits, your ST 
will definitely crash. Also beware of 
video games — some of them can be ex- 
ited only by resetting your machine. 

The only other limitation was men- 
tioned earlier. If your application is a 



TOS program, you must dial through 
the emulator before loading and run- 
ning the main program. Likewise, 
when you receive the on-line signal, 
you must exit before the BBS times out. 
As a rule of thumb do not initiate any 
unstoppable process which requires 
more than a couple of minutes. 

I think that you will find that even 
if you have a full- featured terminal pro- 
gram you will be using it less and less 
as you become familiar with 
"DIALXR." 



Listing 1: 
ST Basic 

108 OPEN "R",»1,"A:DIALXR.PRG",2 

lie FIELD »1,2 AS B$: FOR 1=1 TO 281: 

READ X$ 

128 A$=CHR$ (UAL ("SH"+LEFT$ (X$, 2) ] ) +CHR 
$ (UAL("&H"+RIGHT$ (X$, 2) ) ) 
138 LSET B$=A$: PUT «1, I : NEXT: CLOSE 
ttl: END 

288 DATA 681A, 8888, OlFS, 8888, 8888, 8888 
,8888, 8888 

218 DATA 8888,8888,8888,8888,8888,8888 
, 4879, 8888 

228 DATA 881C, 3F3C, 8826, 4E4E, 5C8F, 4267 
,2F3C,8888 

238 DATA 82F8, 3F3C, 8831, 4E41, 383C, 8886 
,287C,8888 

248 DATA 84D2, 4A98, S7C8, FFFC, 213C, 8888 
, e8E6, 23F8 

258 DATA 88B4, 8888, 81EC, 21FC, 8888, 8844 
,8eB4,4E75 

268 DATA 8C6F, 8881, 8888, 6668, 8839, 8881 
,FFFF,FA81 

278 DATA 6756, 8C6F, 8883, 8886, 664E, eC2F 
,8844,8888 

288 DATA 6688, 88F9, 8888, 8888, 81F4, 8C2F 
,8e8D,888B 

298 DATA 6636, 8839, 8888, 8888, 81F4, 6726 
,8839,8881 

388 DATA 8888, 81F4, 661C, 23F8, e4BA, 8888 
,81F8,86B9 

318 DATA 8888, 1778, 8888, 81F8,88F9, 8881 
,8888,eiF4 

328 DATA 6886, 4239, 8888, 81F4, 2879, 8888 
, 81EC, 4ED8 

338 DATA 2F38, 84A2, 84B8, 8888, 882E, e4A2 
,3F3C,8887 

348 DATA 2F3C, 8883, 8882, 4E4D, 5C8F, 21DF 
,e4A2, 2F39 

358 DATA FFFF, 8248, 33DF, FFFF, 8242, 33DF 
,FFFF,8248 

368 DATA 4E75, 8839, 8881, 8888, 81F4, 6738 
, 8839, 8881 

378 DATA FFFF, FA81, 6638, 8839, 8882, 8888 
,81F4, 6614 



388 DATA 61AE, 88F9, 8882, 8888, 81F4, 13FC 
,e8eF, 8888 

398 DATA 81F5, 4E75, 5339, 8888, 81F5, 6688 
,6192,4239 

488 DATA 8888, 81F4, 4E7S, 2839, 8888, 81F8 
iB8B8,84BA 

418 DATA 6AF2, 8839, 8883, 8888, 81F4, 6648 
,48E7,887C 

428 DATA 8788, 3F39, FFFF, 8888, 13FC, 888E 
, FFFF, 8888 

438 DATA 88F9, 8884, FFFF, 8882, 33DF, FFFF 
,8888,46DF 

448 DATA 23F8, e4BA, 8888, 81F8, 8689, 8888 
,8198,8888 

458 DATA eiF8, 88F9, 8883, 8888, 81F4, 4E75 
,48E7,887C 

468 DATA 8788, 3F39, FFFF, 8888, 13FC, 888E 
, FFFF, 8888 

478 DATA 88B9, 8884, FFFF, 8882, 33DF, FFFF 
,888e,46DF 

488 DATA 2F38, B4A2, 84B8, 8888, 8e2E, 84A2 
,3F3C,8841 

498 DATA 2F3C, 8883, 8881, 4E4D. 5C8F, 3F3C 
,ee2F,2F3C 

see DATA 8883, 8881, 4E4D,5C8F,21DF,e4A2 
i23F8,e4BA 

518 DATA 8888, 81F8, 8669,0088, 1770, eeee 
,18F8,e8B9 

528 DATA 8003, 0888, 81F4, 4E75, 0000, 0000 
,0888,8888 

538 DATA 8888, 8888, 8888, 8882, 2C88, 862E 
,180A,8A8A 

540 DATA 0888, 863C,148C, 8888, 8A88,8E2E 
,8A88, 5A8A 
558 DATA 8888 

Listing 1: 
Checksums 

180 data 790, 71, 953, 224, 020, 764 
, 210, 16, 226, 38, 4184 

268 data 168, 44, 84, 975, 91, 936, 
995, 128, 252, 559, 4216 

368 data 22, 95, 124, 66, 61, 38, 39 
3, 454, 962, 65, 2272 

468 data 485, 462, 143, 278, 197, 98 
9, 867, 931, 159, 449, 4872 



Listing 2: 
Assembly 

; >mMmtMmmmmKMKKKm<K)ClHCKKltKKmCKXMKKKlCKMKKMICKKKKKK 

;» DIALXR » 

;« by Maloney * 

;» » 

I* Copyright 1988 by ST-Log « 

;» » 

; ilMMMimKKXMlCIClCKmCKXMKMICXKKKMKKKKKMKMMKKKKKMKKMKKKK 

■ 

text 
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install_do 



super_do 
loop 

vector-change 

super-exit 
BIOS-nod_do 

dcd-test 

bconout-test 

D-test 

CR-test 



cancel 

trapl3-nornal 
alert-do 



vbl-do 



pea 


super_do 


;address of subroutine 


nove , w 


tt38, - (spl 




trap 




fcall XBIOS 


addq . 1 


tt6, sp 


j DOD StaC k 


c Ir .u 


- (spl 


Ino error code 


nove . 1 


tt768, - (spl 


ibutes to keen 


nove .w 


tt$31, -(spl 


j ke^D function rnrii* 


trap 


ttl 


icall GEMDOS 


nove .u 


96, do 


; index value 


novea. 1 


tt$4d2, ae 


;-vbl_list + 4 i 


tst.l 


(a81 + 


j'is vector available? 


dbeq 


d6, loop 


fif not take branch 


nove. 1 


»vbl_do, -(aei 


j'store address in vbl vector 



nove. 1 
nove . 1 

rts 

cnpi .w 
bne . s 

btst.b 
beq.s 

cnpi .w 
bne . s 

cnpi .b 
bne.s 



cnpi .b 
bne.s 

btst.b 
beq.s 

btst.b 
bne.s 

nove . 1 
addi.l 
bset.b 
bra . s 

clr.b 

nove. 1 
jnp 

nove . 1 
sub.l 

nove.w 
nove. 1 
trap 
addq. 1 

nove. 1 

nove. 1 
nove .w 
nove.w 

rts 

btst.b 
beq.s 

btst.b 
bne.s 



$b4, BIOS-default 
»BIOS_nod_do, $b4 



Jstore old address 
j store new address 



»1, 8(sp] 
trapl3_nDrnal 

111, SfffffaBl 
trapl3_nornal 

»3, 6(spl 
trapl3_nornal 

968, 11 (spl 
CR_test 



;return to continue 

;is device RS-232? 
;if not take branch 

;are we on-line? 
;if so take branch 

;is it bconout? 
fif not take branch 

;is character "D"? 
;if not take branch 



bset.b S8, status-flag ;set prelin bit 



SIS, 11 (spl 
trapl3_nornal 



lis character CR? 
;if not take branch 



tt6, status-flag ;is prelin bit set? 



cancel 



;if not take branch 



ttl, status-flag J is dial bit set? 



cancel 

$4ba, tiner 
«68ee, tiner 



;if so take branch 

;store current tine 
J add 38 seconds 



ttl, status-flag ;set dial bit 
trapl3-nornal ; branch always 



status-f lag 



;reset all bits 



BIOS-default, a8 ;default trap 13 
(aOl ijunp to it 



$4a2, -(spl 
«46, $4a2 



'Push current address 
;nake roon 



1(7, -(spl ;Control-g (ring belli 

1t$88e38082, -(sp) iconsole and bconout 
S13 ;call BIOS 

tt6, sp 'Pop stack 



(spl+, $4a2 

Sffff 8248, -(spl 
(spit, $ffff 8242 
(spl«, $fff f8240 



;pop address 



fpush palette regs 8 & 1 
;pop 8 to palette reg 1 
;pop 1 to p'alette reg 8 

;return to continue vbl-do 



ttl, status-flag ;is dial bit on? 
vbl-exit ;if not take branch 



«1, $fffffa81 
redial-test 



;are we on-line? 
;if not take branch 



btst.b tt2, status-flag ;is connect bit set? 
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bne.s 


alert-test ; 




bsr.s 


alert-do I 




bset.b 
nove.b 
rts 


tt2, status-flag ; 
«15, tiner-A ; 

} 


alert-test 


subq.b 
bne.s 


»1, tiner-A ; 
vbl_exit ; 




bsr.s 


alert_do l 




clr.b 


status-flag ; 


vbl— exit 


rts 




redial_test 


nove. 1 
cnp . 1 
bpl.s 


tiner, dO ; 
$4ba, dO ; 
vbl-exit j 




btst.b 
bne.s 


tt3, status-flag ; 
redial-do ; 




nove 
ori 

nove .u 
nove . b 
bset.b 
nove.w 
nove 


sr, -Csp) ; 
It$67e8, sr ; 
$ffff880e, -Csp) 

si4,$ffff88e8 ; 
tt4, $ffff88e2 ; 

Csp)+,$ff ff8888 
Csp)+, sr ; 




nove. 1 
addi . 1 
bset.b 
rts 


$4ba, tiner ; 
11488, tiner ; 
»3, status-flag ; 


redial-do 


nove 
ori 

nove.w 
nove.b 
bclr.b 
nove.w 
nove 


sr, -Csp) J 
tt$8788, sr ; 
Sffff88e8,-Csp) 
ttl4, $ffff8888 
tt4, $ffff8882 
Csp)+, $ffff8888 
Csp)-!-, sr ; 




nove. 1 
sub.l 


$4a2, -Csp) ; 
tt46,$4a2 : 




nove .w 
nove. 1 
trap 
addq. 1 


1t6S, -Csp) ; 
»$ee838881, -Csp) 

tii3 ; 
tt6, sp ; 




nove.w 
nove . 1 
trap 
addq . 1 


«47,-Csp) ; 
tt$88838081, -Csp) 

tti3 ; 
sG, sp ; 




nove . 1 


Csp)-!-, $4a2 ; 




nove. 1 
addi . 1 
bclr.b 


$4ba, tiner ; 
116888, tiner ; 
S3, status-flag ; 




rts 




BIOS-default 
tiner 

status-flag 


bss 
ds.l 
ds.l 
ds.b 


1 
1 
1 



if so take branch 

ring bell and reverse screen 

set connect bit 
set tiner to l/'4 second 
return to vbl int handler 

tine for alert-do? 
if not take branch 

ring bell and reverse screen 

disable redial 

return to vbl int handler 

get target tine 
is wait finished? 
if not take branch 

is redial bit set? 
if so take branch 

push status register 
disable interrupts 

Jpush last register used 
select port A 
set dtr bit 

;pop last register used 
pop status register 

store current tine 
add two seconds 
set redial bit 
return to vbl int handler 

push status register 
disable interrupts 

;push last register used 
;select port A 
;reset dtr bit 
jpop last register used 



jRS-232 & bconout 
call BIOS 
pop stack 

■V" 

;RS-232 & bconout 
call BIOS 
pop stack 

pop address 

store current tine 
add 38 seconds 
reset redial bit 

;return to vbl int handler 



status-flag bit assignnents: 
8 prelin 

1 dial 

2 connect 

3 redial 
tiner-A ds.b 1 



end 
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from Hollywood, U.S.A. 



by TG 



Have You Heard That. . . 

Some Atari executives have been 
■working nights preparing an advertis- 
ing campaign. Most at Atari now be- 
lieve that the need for real advertising 
is crucial. Now if only they can get Jack 
T. to listen .... 

Strong rumors out of the West Coast 
indicate that if the cost of memory 
(RAM) chips doesn't fall soon, the cost 
of ST's in general, and Megas in partic- 
ular, will be going up. This has already 
started happening in the PC world as 
the cost of clones and the various cards 
for them have started climbing for the 
first time in four years! 

The Atari Super High Res Monitor 
has been sitting on a shelf in Sun- 
nyvale for months waiting for the price 
of one meg chips to drop low enough 
to make the unit salable. What is this 
monitor? We hear it includes one meg 
of screen IIAM built into the unit, with 
a 68000 chip for graphics processing. 
As well as maximum 1280 X 960 reso- 
lution and connection to the ST via the 
DMA port. This is supposed to be the 
monitor for the legendary EST (En- 
haneed ST), as well as the unit to be 
packaged with the ABAQ. 

T\meworks has high hopes for their 
new product Desktop Publisher. 
Many who have seen it say the new 
GDOS-based desktop publishing pack- 
age is much stronger than the old 
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Publishing Partner. Looks like the 
update from the guys at SoftLogic will 
come just in time to help them keep 
their position as Atari's number one 
DTP package. For those who haven't 
seen the package from Timeworks, it 
really is quite nice. The software uses 
GDOS to give a very readable screen 
representation of your final output. 
Among the many features that give this 
package super user-friendliness is the 
ability to take a graphic and drop it 
anywhere on your screen. Any text you 
may have on the screen will just move 
out of the way and automatically flow 
around the graphic. 

Speaking of user friendliness, any- 
one who has tried to use the GDOS in- 
stalled program provided with 
Microsoft Write has a clear lesson 
in what that term does not mean. 

Still speaking of GDOS and Publish- 
ing Partner (and 1 know we spoke of 
them somewhere back there), a short 
conversation with the programmers at 
SoftLogic indicated that they think a 
lot more of the Atari laser printer now 
that they have had a chance to work 
with it a few months. According to 
them it will print from the new Pub- 
lishing Partner much faster than 
the old trusty Apple laser printer they 
bought a few years ago. In fact, they 
now feel, all things considered, it's the 
laser printer of choice for the new 



Publishing Partner. 

Is it true that Atari is working on a 
new version of GDOS that will load re- 
scalable font descriptions rather than 
those archaic bit mapped memory hogs 
they are now using? That's what we 
hear. 

How's the new, new operating sys- 
tem coming? For those of you who 
missed a few weeks somewhere along 
the line. Atari released a new 
"debugged" version of the operating 
system with the Megas some months 
ago. Then, just as the chips were start- 
ing to appear in the 1040s and 520s, 
Atari's Neil Harris, announced they 
were ready to button up the code on 
the new, new operating system. Atari 
was interested in any suggestions that 
user's might have which could be in- 
cluded to make it better. Hundreds of 
suggestions arrived (seems like half of 
them were asking for the Universal 
Item Selector to be included). Atari 
shut off suggestions after a reasonable 
period of time, and we were told they 
were busy figuring out what would and 
would not be included. 

One small computer store in western 
Massachusetts, Ttie Computer Bug, has 
decided not to wait, and has just writ- 
ten a new graphic interface for the STs. 
This new Interface offers some of the 
(continued on page 46) 
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GAME 



Low Resolution 
Only 



by Clayton Walnum 

Moonlord Planetinsky was still a bit- 
ter man. 

Even though he had succeeded In vir- 
tually single-handedly defeating last 
year's alien attack (the entire 
Titanian Territorial Guard had been 
stymied by the aliens' unusual strate- 
gies), even though he returned home a 
hero to the adulation of thousands, he 
found that, deep inside where it really 
counted, he was still as insecure as a 
newborn cub. 

It was the name, you know. 

It sounded so much like a title of 
office that people could rarely resist 
bowing when introduced. It was a mat- 
ter of amusement for most, but Moon- 
lord hated it. 

His childhood had been no laughing 
matter, either. He had always been the 
one with the cootiumphaloids (imagi- 
nary creatures about the size of a tem- 
phibootawep; if the other kids said you 
had them, you were an outcast), and 
now as an adult, he still found that his 
unusual name was anything but an 
asset. 

Why, he often thought, couldn't he 
have been given a normal name like 
Fredolotington Alnertopater or Ed- 
dyboperty Elnopilersop? 

So he became tough — the toughest 
starfighter on the Saturnian moon of 
Titan. Nobody— nobody— dared cross 
him. 

Now it seemed he had another job to 
do. 



Moonlord stepped off the Slider- 
walkatron and crossed to the head- 
quarters of the Titanian Territorial 
Guard, clutching the telegramomes- 
sagecard in his left hand. It was from 
Leeryup Coddledoop, Commander-in- 
Chief of the TTG. He snickered to him- 
self as he remembered the last time he 
had seen Leeryup, tucked into a hospi- 
tal bed, every part of his body except 
the bones swollen like over-filled 
cameladesertliquibags. 

"Guess he won't bow to me again!" 
Moonlord said out loud. A few people 
glanced in his direction, but none let 
his gaze linger. Moonlord was a hero— 
and they loved him— but they knew 
better than to draw attention to his 
peculiarities. He drew a deep lungful of 
smoke from his smokyngstickolungo- 
lator, and exhaled a swirling blue 
tornado. 

When he stepped into Commander 
Coddledoop 's office, the gray-haired 
man behind the desk stood up and 
saluted. Even though Moonlord was a 
civilian, he now received the same 
respect as that awarded to an Admiral 
of the fleet. To say the least, the TTG 
were inordinately impressed by Moon- 
lord's handling of the last alien 
invasion. 

Moonlord sat down without return- 
ing the salute, and stared at the Com- 
mander, saying nothing. 

The Commander sat slowly, fighting 
the urge to bow with all his soul. 
Heavens, but old habits died hard! 

"Uh . . . ahem," he began eloquently. 
". . .uh. . .To say the least, the TTG 
were inordinately impressed by your 
handling of the last alien invasion." 

Wow, thought Moonlord, Deja vu. But 
he said nothing, just sat, waiting. 

"We have a tiny problem," the Com- 
mander tried again, "one that requires 
your. . .er. . .delicate touch." 

Moonlord's eyebrows climbed his 
forehead. "You wouldn't by any chance 
be referring to the new fleet the aliens 
have sent out, would you?" 

"Well... it's a problem kind 
of. . .er. . .similar to that." 

"Similar?" 

"Um. . .very close to that, actually." 
"How close?" 

"Sort of. . .well. . .'identical' would 
be the appropriate word, I guess." 

Moonlord sighed. "Are you or are you 
not referring to the new alien threat?" 

"I believe that would be an accurate 
paraphrase of my previous remarks." 

"Have you ever considered politics?" 
Moonlord asked. 
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"Well ..." 

"Never mind. It was a rhetorical 
question." 

Moonlord stood up and crossed to the 
Commander's newly installed 
compudigibinotometer-ST, the one that 
had recently replaced the long-loved 
compudiglbinotometer-XE, and called 
up the galactic map. 

The aliens were everywhere. 

"Let the good-times roll," Moonlord 
muttered. 

"Excuse me?" said the Commander, 
standing to get a better look at the 
screen. 

"I'll take the job," Moonlord said, 
turning toward the Commander. "I'll 
show those alien scum that they can't 
mess with Titan." 

The Commander positively glowed. 
"Thank you, thank you, thank you!" 
He was so delighted that he forgot to 
control his inner impulses. Before he 
knew it, he was bending at the waist, 
performing an elegant bow. "Ohhhhh, 
nooooo . . . " he muttered. 

It was the Commander's opinion that 
hospital food hadn't improved much 
since his last stay. 

So, where is it? 

Moonlord ST is a translation of the 
original Moonlord published in issue 
46 of ANALOG Computing. Those of 
you who are familiar with that game 
wiU find that this version, though 
greatly enhanced graphically and us- 
ing the mouse instead of a joystick for 
input, is almost identical in game play. 
The only differences are the addition 
of a novice level and the ability to 
"ram" alien craft. 

Actually, there is one other major 
difference: You don't have the option 
of typing in the program for Moon- 
lord ST. Just like most full-scale ST 
programs, the source code is much too 
large to be published here. All game 
files and the source code are available 
on this month's disk version or on the 
Delphi ST SIG. 

Note that the file MOONLORD.DAT 
must always be in the same directory 
as the main program file, MOON- 
LORD.PRG, and the disk should remain 
in the drive during game play. 

Ploying Moonlord ST 

When you run the program, the first 
thing you'll see is the title screen. Af- 
ter you've finished admiring Maurice 
Molyneaux's excellent work, click the 
left mouse button and select a level of 



play. Those who've never played 
Moonlord before should select the 
novice level. Moonlord is a tough 
game to complete and, until you've 
managed to develop some good strate- 
gies, you won't have a chance on the 
expert level. The novice level gives you 
a higher energy allotment, and the 
aliens' attacks have a lesser chance of 
damaging your ship. 

After selecting your level, you'll see 
the galactic map, represented on your 
screen by an 18 x 8 grid. Each square 
in the grid is one sector of the galactic 
milieu, and hidden within these 144 
sectors are the 50 alien craft you must 
locate and destroy. Since aliens always 
travel in pairs, only 25 sectors actual- 
ly contain the enemy. 

To make your job a little easier, there 
are two starbases you can dock with, 
to stock up on supplies and make 
repairs. There's one at each end of the 
galaxy, and, of course, just like the 
aliens, they're randomly placed at the 
beginning of each game, forcing you to 
explore. 

To win the game, you must locate 
and destroy all 50 alien craft. You have 
only 100 Galactic Standard Days in 
which to complete your mission. It'll 
take careful conservation of supplies 
and planned movement, so those who 
like to leap into the fray without a 
strategy will And failure a constant 
companion. 

Though there's only one way to win 
the game, there's many ways to lose 
(can't make it too easy for you, now can 
we?). The first is to run out of time. 
You've got 100 days. No extensions. All 
begging will be ignored. 

The second way to lose your hero sta- 
tus is to allow your energy to run out. 
Keep your eye on it; when it's gone, so 
are you. Don't forget to check the sta- 
tus of your weapons, either. If you 
should be in the heat of battle and find 
that both your weapons systems are 
down, you'U have to resort to ramming 
the aliens (more on that later). That 
means heavy damage. Also, every time 
you ram an enemy, you're taking a 
one-in-ten chance of destroying your 
own ship. 

Finally, use of your ship's warp capa- 
bilities is a risky venture indeed. Each 
time you decide to utilize them, you're 
taking a one-in-ten chance of destroy- 
ing your engines and ending the game. 

The bridge 

Below the galactic map, you'll find 
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the bridge. This is where you gain ac- 
cess to the ship's main functions. 
There are four systems available here: 
scanners, cruise engines, a status dis- 
play, and warp engines (weapon sys- 
tems are accessed from the scanner 
display). To select a system, place the 
mouse pointer over the system name 
and click the left mouse button. 

Note that at times some of your sys- 
tems will be damaged and thus unusa- 
ble. You can tell at a glance which sys- 
tems are down: their entries in the sys- 
tems menu will be disabled. The only 
exception to this is the long-range scan- 
ners. They work automatically each 
time you move, so they have no menu 
entry. You can check them on the sta- 
tus display (see the section "Status" 
below). 

Cruise 

To move your ship from one galactic 
sector to another, select the "cruise" 
command. You are allowed to move in 
any of the eight compass directions, 
but you should note that diagonal 
moves are actually counted as two 
moves, and the required energy and 
time are deducted as if the move were 
completed with two non-diagonal 
moves. When you click on the cruise 
systems, you'll be asked to select your 
destination sector. Place the mouse 
pointer over the sector and click the 
left mouse button. Your ship will ap- 
pear in the target sector. 

Each sector of movement uses ten 
units of energy and one day of time. 

Status 

Throughout the game, it s important 
to keep close tabs on your ship's con- 
dition and supplies. You can't afford to 
be stuck far from a starbase when your 
energy is almost depleted, and it helps 
to know what weapons are functional 
before you spring into battle. All this 
information is available in the status 
display. To view the status display, 
select the "status" system from the 
bridge menu. The status display screen 
will then pop into view. 

Your ship's six systems are displayed 
on the left, each followed by a number 
indicating how many days are needed 
to repair that system. A zero means the 
system is fully functional. 

On the right, information on sup- 
plies, as well as the time remaining and 
the number of aliens remaining, can be 
found. 



Damaged systems 

Damaged systems must be repaired 
before they can be used. Damage is 
measured by the number of days the 
crew requires to complete repairs. If 
you don't need the damaged system 
right away, you need do nothing. The 
crew will automatically get to work, ap- 
plying their best efforts to the restora- 
tion of your ship. Remember: One sec- 
tor of movement on the galactic map 
consumes one day. A system that re- 
quires three days to repair will be oper- 
ative after a move of three sectors. 

If you find you must make repairs 
immediately, before continuing with 
the game, you may do so by selecting 
the "repair" system from the status 
subsystem menu. Use the mouse to tell 
the ship's computer how long you wish 
to wait for repairs by placing the mouse 
pointer over one of the arrows and 
clicking the left mouse button. When 
you're satisfied with your selection, 
press the right mouse button. The 
repairs will be made and the status 
screen updated. 

If more than one system needs 
repair, the times are not added 
together. Each system has its own 
crew. For example, if your photon 
launchers require four days to repair, 
and your short-range scanner needs 
two days, it'll take only four days to fix 
both systems. Given the above circum- 
stance, if you should select only two 
days of repair time, the short-range 
scanner will be operational, while the 
launchers will require two additional 
days of repair before you can use them. 

Don't forget that the time you spend 
waiting for repairs will be subtracted 
from the time available to your mis- 
sion. Sometimes it's better to continue 
crippled then to waste a lot of time 
waiting for repairs to be completed. 

Warp 

Should you find that you must move 
a long distance in a minimum amount 
of time, the warp engines may fill your 
need. Unfortunately, the warp engines 
are still experimental; their safety and 
reliability cannot be guaranteed. You 
have no control over where you'll end 
up, and each warp carries a one-in-ten 
chance of leaving you engineless, help- 
lessly afloat in the timeless void of 
space. In other words, the game could 
come to an abrupt end. 

Each wrap consumes one day and 30 
units of energy. Due to its undependa- 
bility, you may have to jump several 
times before you get where you want 
(or at least In the general area). 
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Long-range scanners 

You have two types of scanners on 
your ship: long- range and short-range. 
The long-range scanners fill in the 
galactic map as you move, and since 
they function automatically, you need 
do nothing except repair them when 
they become damaged. 

The long-range scanners examine 
the sectors adjacent to your position 
and mark the galactic map appropriate- 
ly. Empty sectors are indicated by a 
white dot, aliens are represented by a 
red circle, and starbases by a blue cir- 
cle. Your current position is marked by 
a green circle. In most cases, your po- 
sition marker will be outlined in yel- 
low. However, if you should be in a sec- 
tor containing aliens or a starbase, 
your marker will be outlined in red or 
blue, respectively. 

Short-range scanners 

The "scan" system on the bridge 
menu activates the short-range scan- 
ners. When you select this system, the 
short-range scanner display will pop 
up. 

The short-range scan allows you to 
see your current sector in greater de- 
tail. Each sector of the galactic map is 
divided into 36 smaller sectors. Suns, 
aliens, starbases, as well as your own 
ship are all represented by icons on the 
short-range scan display. Four systems 
commands are available from the 
short-range scan sub-system (SRS8S) 
menu: bridge, cruise, phaser and 
photon. 

To return to the bridge, select the 
"bridge" option. 

Short-range cruise 

You may move about in the short- 
range display in much the same man- 
ner as in the galactic map. Select the 
"cruise" system from the SRS8S menu, 
press the left mouse button, then use 
the mouse to select your destination. 

Unlike the galactic map, your move- 



ment here is somewhat restricted. You 
can't move through a sun, an alien or 
a starbase. If anything is in your way, 
you must maneuver around it. Also, 
"diagonal" moves are not allowed. This 
is because, as I mentioned before, di- 
agonal moves are interpreted as two 
non-diagonal moves. Since the aliens 
will attack each time you move, only 
single moves are allowed. 

Movement on the short-range display 
consumes no tune, but uses three ener- 
gy points per sector. 

Phosers 

The phasers are the first of your 
weapons systems, and your most 
powerful. When activated, they release 
a burst of electro-magnetic energy in 
every direction, damaging any alien 
craft on your scanners. Nothing can 
block their energy beams, not even a 
sun. The amount of damage done de- 
pends on the munber of alien craft 
present and the distance they are from 
your ship. Damage is cumulative. You 
may have to fire more than once to get 
the job done. 

To activate the phasers, select the 
phaser system from the SRSSS menu, 
then use your mouse to tell the ship 
computer the amount of power to allo- 
cate. (Click on the arrows to increase 
or decrease the amount, and then press 
the right mouse button.) Each power 
point will be subtracted from your re- 
maining energy, so be stingy, allocat- 
ing just enough to get the job done. 

Photons 

Photon torpedoes (globes of compact- 
ed light energy) can be used to fire on 
any alien craft that is in alignment 
(horizontally, vertically, or diagonally) 
with your ship. Their range is sufficient 
to strike any ship on your scanners, 
and a strike is always fatal. To Are a 
photon, select the photon system from 
the SRSSS menu, and then use the 
mouse to click on the appropriate point 
on the photon aiming compass. 

Firing a photon consumes no ener- 
gy, but nothing comes for free. In or- 
der to fire photons, your launchers 
must be in working order, and you 
must have photons on hand. At the 
start of the game, you are given ten 
photons. You'll be restocked only when 
you dock with a starbase. Obviously, 
you're going to have to use them 
judiciously. 

Ramming 

If you should And yourself in the 
midst of battle with all your weapon 
systems down, you can still defeat the 



aliens by ramming them with your 
ship. Because your ship is much larg- 
er than the aliens', this will always be 
fatal to the enemy. However, by resort- 
ing to such desperate measures, exces- 
sive damage may be caused to your 
ship. Specifically, up to three systems 
may be damaged, and there's a one-in- 
ten chance that the damage will be 
sufficient to cripple your ship perma- 
nently, thus ending the game. 

Starbases 

When you set out from Titan Base, 
your ship will be carrying all the sup- 
plies it can hold. It'll be necessary at 
certain points in the game to stock up. 
For this reason, there are two star- 
bases, one at each end of the galactic 
milieu. 

The starbases move from game to 
game, and will not be marked on the 
galactic map until you locate them— 
one of your top mission priorities, ob- 
viously. Once you locate a starbase, you 
must— if you plan to restock your sup- 
plies and make repairs — go to the 
short-range scanners and dock with 
the base. Docking is accomplished by 
moving your ship on top of the base. 
All your supplies wUl be restocked, and 
all systems will be repaired. 

Mission complete 

All missions, regardless of success or 
failure, wiU be evaluated by the person- 
nel at Titan Base. Your score is based 
on the nimiber of aliens you destroyed, 
as well as the amount of time and ener- 
gy you used (the less, the better). Also, 
you'll get much higher scores at the ex- 
pert level than you will at the novice 
level. 

At the end of the game, if you want 
to play again, press the left mouse but- 
ton. To exit back to the desktop, press 
the right mouse button. 

Kudos 

I wish I were an artist, but I'm not. 
Though I designed all the game screens 
and icons, it was ST-Log Contributing 
Editor Maurice Molyneaux who made 
them come to life. He took what were 
only barely acceptable displays and 
turned them into a professional- 
looking piece of work. Thanks, 
Maurice! 

The sound effects for Moonlord ST 

were created using G.I.S.T. by Lee Ac- 
tor and Gary Levenberg of Synthetic 
Software (G.I.S.T. is available through 
The Catalog). This is a sensational pro- 
gram that takes all pain out of gener- 
ating sounds and makes Implementing 
those sounds in your programs simple 
beyond belief. 
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From Art to 
Engineering 

by Karl E. Wiegers 



Long ago, in a galaxy far, far away, 
people began to program computers. At 
that time, the computer itself was a 
room-filling monstrosity, and the 
programming challenges were quite 
different from those of today. Every- 
thing was done at a machine language 
level, which is dandy for computers but 
a bit taxing on the human eye. 

Not so long ago, in a nearby galaxy, 
people started programming in assem- 
bly language, and then in third- 
generation ("high-level") languages 
such as FORTRAN, COBOL, and PL/I. 
The programs became larger as the 
machines shrank. Unfortunately, the 
software problems became larger, too, 
and some interesting trends began to 
emerge. 

Large software projects were nearly 
always completed over budget and late, 
if at aU. The danged users kept chang- 
ing what they wanted, and the over- 



taxed programmers could scarcely 
keep up with them. Hence, programs 
were forever being altered after they 
were declared complete. In fact, data- 
processing departments were spending 
several times the dollars and man- 
years that they anticipated for program 
maintenance (adding enhancements, 
fixing bugs, and changing to conform 
to current user requirements). 

Just yesterday, in the galaxy right 
next door, the microcomputer was in- 
vented. This opened the world of com- 
puting to a whole new generation of 
amateurs: hackers, if you like. We were 
back to assembly language, although 
Bill Gates soon opened the floodgates 
of high-level languages by introducing 
the first BASIC interpreter for micros. 

Now, hackers tend to be an indepen- 
dent lot. (For an informative and enter- 
taining historical perspective, read 
Hackers, by Steven Levy.) In the early 



days, clever microcomputer program- 
mers taught their machines how to 
sing, dance, and show pretty pictures. 
They were more concerned with the 
latest animation techniques than with 
writing structured, maintainable code. 
And, hey, with only 16K or so to work 
with, you can live with that. But again, 
the computers got smaller, cheaper, 
and more powerful at an astounding 
rate, and the programmers only slow- 
ly figured out better ways to create the 
code that rapidly expanded to fill all 
available RAM. 

Today, on our very own planet, there 
is a widely recognized "software crisis." 
The rate of progress in software de- 
velopment hasn't begun to keep pace 
with that of the rapidly evolving hard- 
ware on which the programs run. The 
expectations of users have gone up, and 
software customers often are dissatis- 
fied with the final product they ac- 
quire. The quality of the software often 
leaves something to be desired. Main- 
tenance has become a major issue: look 
how many different releases of com- 
mercial packages appear and the fresh 
problems that crop up with each new 
version. And the developers frequent- 
ly don't have a good idea of how long 
it's really going to take to get the next 
product out the door. The result is 
vaporware. 

In short, we can no longer afford the 
luxury of computer programming as 
art, except for those who still view 
programming mainly as an exception- 
ally intriguing hobby and learning ex- 
perience. To make a buck with soft- 
ware now requires a more systematic, 
rigorous, and structured approach, 
akin to that used for producing the 
computers themselves. The old gener- 
ation of computer programmers as in- 
dependent artists is (slowly) giving rise 
to a new generation of "software en- 
gineers." 

Is this really such a big deal? Well, 
consider that IBM estimated the world- 
wide costs of software development 
and maintenance in 1986 to be some 
$135 billion. That's a fair piece of 
change. And while computing hard- 
ware has been growing in speed and 
power at a rate of around 30 % per year, 
software development productivity 
seems to be Increasing at only about 
4% annually. 

Yes. It is a big deal. 

Wherefore Software 
Engineering? 

Software is just like hardware, only 
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completely different. Hardware (mean- 
ing machines of any kind) can wear 
out; software can't. (Of course, the flop- 
py disk can wear out and the software 
can become obsolete, but these are 
hardware and business problems, 
respectively.) Hardware can be 
rigorously tested to make sure it works 
right under specified conditions— it 
can be stressed. There's no way to ex- 
haustively stress-test most software. 
Once in place, hardware is difficult and 
expensive to update, whereas software 
can be changed much more readily, at 
least from the user's point of view 
(think of the contents of a book versus 
the contents of a floppy disk). 

Here's a simple hardware/software 
comparison you can do in the privacy 
of your own mind. When was the last 
time you asked the Maytag man to 
come out and add a variable speed op- 
tion to the spin cycle on your washing 
machine? Now, when was the last time 
you sat at a keyboard and said, "Gee, 
the next version of this program Is sup- 
posed to be able to. . . ." 

Despite these differences, the soft- 
ware development sequence does have 
a well-defined life cycle, quite similar 
to that of hardware development. The 
historical view considered the software 
life cycle to consist of steps to analyze 
the problem, design a software solution 
for the problem, write the required pro- 
grams, test the system, install it, and 
maintain it. The goal of software en- 
gineering is to provide a more con- 
trolled approach to the software life cy- 
cle that will facilitate the efficient de- 
velopment of higher quality products 
than was possible using earlier 
methods. 

Here's an irony for you. The hard- 
ware business has been revolutionized 
by the techniques of computer-aided 
design (CAD), engineering (CAE), and 
manufacturing (CAM). Doesn't it seem 
strange that the software industry is 
still so dependent upon the individual 
efforts of individual human beings? 

The software engineering philosophy 
does emphasize the use of automated 
tools to facilitate the program develop- 
ment process. Such tools include 
computer-aided software engineering 
(CASE) products, as well as program- 
ming environments and utilities op- 
timized for productivity. The latter in- 
clude such things as syntax checking 



program text editors, powerful compil- 
ers, linkers and debuggers, and usabil- 
ity environments like GEM. 

But tools of any kind are only useful 
if they are applied In the context of a 
systematic methodology. Several soft- 
ware engineering methodologies (or 
"paradigms," If you want to baffle your 
friends and alienate your in-laws) have 
evolved in recent years. Some of these 
Involve graphical "languages" for the 
structured analysis and design of soft- 
ware systems. We'll talk about some of 
these later on. 

Another aspect of software engineer- 
ing is the development of procedures 
for managing and monitoring the tech- 
nical activities involved in program de- 
velopment. For example, how do you 
measure the productivity of a software 
engineer? With hardware, it's easier to 
measure productivity in terms of quan- 
tity (how many widgets?) and quality 
(did they all do their little widget thing 
right?). What does software quality 
even mean? And if you can't measure 
your productivity, how can you realisti- 
cally project how long It will take you 
to complete a particular project? Tough 
questions, with no easy answers. 

Software Life Cycles: Before 

Many of you began your computing 
career with an 8-blt Atari of some sort. 
What was the "life cycle" of a program 
you wrote back then like? Well, you be- 
gan with an Idea. That was your plan- 
ning step. You probably had a rough 
idea of how to proceed. That was anal- 
ysis. If you are a particularly systemat- 
ic person, you might have drawn out 
a flowchart, at least for the trickier sec- 
tions of the program. That was the de- 
sign step. But most of the time you 
skipped design and went right into cod- 
ing, which consisted of typing your 
lines of Atari BASIC code as fast as you 
could into a single source code file, 
with perhaps a subroutine or two. 

Testing consisted of typing RUN and 
observing what happened, then chang- 
ing the lines that blew up (BASIC inter- 
preters are great for sloppy ... er ... I 
mean casual program development). 
Installation consisted of giving a copy 
to a friend. Maintenance didn't really 
exist, partly because you were on to the 
next project, and partly because you 
didn't have any documentation (huh?) 
to remind you of what you did. 

Don't try to lie to me about this; 
I've been there. 

This unstructured, evolutionary 



programming approach works moder- 
ately well for smallish BASIC programs, 
but there are some problems, besides 
the obvious high chaos level. One is 
that your variables in Atari BASIC are 
all global; that is, they are known to all 
parts of the program. WhUe this is con- 
venient, it's also dangerous, because 
you can inadvertently use the same 
variable name for different purposes. 
Also, you are limited to single flies of 
BASIC source code, since there aren't 
easy ways to join multiple files 

I hope you 
don^t feel 
that all this 
talk about 
engineering 
is taking the 
fun out of 
computer 
programming. 

together. You can, of course, run one 
program from another, but you can't 
really link two smaller programs 
together to create a large one. 

BASIC is not a highly structured lan- 
guage, making it difficult to partition 
a program into discrete, bite-sized 
pieces that fit together nicely. The lack 
of good selection logic statements (like 
IF/THEN/ELSEIF) makes it hard to ad- 
here to the structured programming 
precept of each program having exact- 
ly one entry point and one exit point. 
I've seen spaghetti code mazes of GO- 
TOs and GOSUBs that would turn your 
hair white. And the need for line num- 
bers makes it hard to create libraries 
of useful subroutines to merge into 
different programs you might write. 
Did you ever try to squeeze some code 
In between lines 1304 and 1305? 'Taint 
easy. 

Things in the Atari world have 
changed, along with the rest of the 
computer world. Modem languages for 
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the ST, such as C, Pascal, and the new- 
er BASICS Uke GFA and LDW, are more 
structured and modular. They let you 
write smaller program segments (called 
"modules") to perform specific func- 
tions, compile them separately, and 
link them together to create the run- 
time program. In the 8-bit Atari en- 
vironment. Action! comes closest to be- 
ing a modem, structured language. 

As memory became cheap and abun- 
dant, programs became big and com- 
plex. It's much easier to create and 
modify a small program performing a 
single function than a large monolithic 
program. The trick, then, is to break a 
large program into a bunch of small 
modules, each of which can be 
designed, coded, and managed easily. 
You build a large software system by fit- 
ting together lots of small modules like 
bricks. The mortar that binds the mod- 
ules together is the data interface be- 
tween each pair of modules. By precise- 
ly defining these data interfaces (vari- 



ables passed, etc.), it becomes easy to 
reuse an existing module. Also, the in- 
formation within each module can re- 
main local to that one module, 
minimizing inadvertent variable 
changes that wreak havoc elsewhere in 
the program. 

Software Life Cycles: After 

The sequence of events involved in 
creating a large system in the software 
engineering mode is somewhat differ- 
ent from that followed in the days of 
yore. The advantages become especial- 
ly great if there are several people 
working on the same project. Let's see 
how you might do things in 1988, us- 
ing a software engineering approach. 

1. Perform a thorough, structured 
analysis of the problem, including writ- 
ing a complete list of specifications 
describing what the system is sup- 
posed to do. I'll describe what I mean 
by "structured analysis" in the next 
section. Make sure you are solving the 
right problem, and that you under- 
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stand exactly what the program (or sys- 
tem of programs) must accomplish to 
be successful. The more complete the 
statement of requirements is, the more 
likely you are to come up with a satis- 
factory system. 

2. Design the software system in de- 
tail before ever writing any code. Make 
sure the system you design is valid, 
complete, and can be implemented us- 
ing the language(s) and hardware you 
have in mind. Believe me, it's much 
easier, faster, and cheaper to correct an 
error in the design than to fix the final 
product. Structured diagramming tech- 
niques can be used in the design step, 
and computer-aided software tools ex- 
ist to help with this step (more about 
these later). 

The hard part here is forcing your- 
self to hold off on coding until the de- 
sign is complete. Face it, we all pro- 
gram computers because we love it. I've 
found it very difficult to discipline my- 
self enough to avoid coding until I'm 
really sure of what I need to do, but it's 
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usually worth the wait. Oh, all right, I 
admit it, I'll write snippets of code to 
try things out, but I call it "prototyp- 
ing," so that's okay. (In fact, prototyp- 
ing is an alternative software life cycle 
methodology that can be very effective, 
but that's a topic for another day.) 

An important part of your design is 
to partition the problem into small 
enough pieces so that each program 
module is performing a single func- 
tion. How you define "single" is up to 
you, but generally you want to try to 
limit module size to 100 lines of source 
code or less. Effective partitioning 
makes it easier to spread the work 
among different programmers. Also, 
you can identify modules that can be 
reused, either from a previous project 
or in the next project. This off-the-shelf- 
parts approach is another effective 
aspect of hardware engineering, and 
the payoff is just as great with software. 

Each module should be designed to 
fit together with the others indepen- 
dently, essentially as a "black box" 
whose internal functioning isn't real- 
ly important to other modules (or to 
people who use it as a part of another 
system, for that matter). Modules com- 
municate through a well-defined data 
interface of passed variables and data 
structures. Try to avoid using global 
variables wherever you can, for the rea- 
sons mentioned earlier. Try to hide the 
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data within each separate module from 
the other modules. 

4. Okay, now you can write the pro- 
gram! Use good structured techniques, 
stick to the data interfaces described in 
the last paragraph, give your variables 
descriptive names, and avoid GOTO 
statements. Stick to the three main log- 
ical program building blocks of se- 
quence (one statement after the other), 
selection (choosing one path from a 
choice, such as IPyTHEN/ELSE or 
SELECT/CASE constructs), and itera- 
tion (FOR/NEXT type processing). Each 
module should have just one entry 
point and one exit point. These goals 
aren't always 100% achievable, but do 
your best. 

There was an excellent series of arti- 
cles about using structured program- 
ming techniques in BASIC way back in 
the May/July 1984 issues of the now- 
defunct Creative Computing magazine. 
The ideas apply to any language, 
although they are harder to implement 
in BASIC (or assembler— forget it!) than 
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in newer languages. Any modem com- 
puter programming textbook will also 
describe structured programming 
principles. 

5. Integrate the modules and test 
them to assemble the final, completed 
software system. If you do this right, 
you can fit the pieces together a bit at 
a time, either from the top of the pro- 
gram down or from the bottom up. 
Whole books can be written on soft- 
ware testing, so I won't go into detail 
here. Suffice it to say that all of us can 
do a better job of testing our products, 
by systematically going through a wide 
selection of test case input. Don't for- 
get to look at the output. Just because 
the program didn't crash doesn't mean 
it worked right! 

6. Document what you did, both in 
the source code (internal documenta- 
tion) and in separate written form (ex- 
ternal documentation). If you did a 
good job of design, much of your exter- 
nal documentation is already complete. 
Don't forget things like lists of the files 
involved, data file formats, etc. It's al- 
ways important to include some com- 
ments in the source code about what 
the module is for, the details of the data 
interface for the module, variable and 
subroutine names and functions, and 
so on. Don't base your documentation 
on just what you see in published pro- 
gram listings, either. Some of it is very 
good, but much is too scanty for 
commercial-scale development. 

But I Like to PROGRAM! 

I know. The software engineering 
philosophy involves a lot of front-end 
effort before we ever get to the really 
enjoyable part of writing code. And for 
the casual programmer, who does this 
just for fun, it isn't worth the time to 
really do all the systematic ground- 
work that 1 described. But it works! 

The first time I tried using structured 
program design methods, I felt that I 
enjoyed about a tripling of my efficien- 
cy. The quality of the programs you 
write will go up if you take even a limit- 
ed engineering approach. And you'll 
really become a believer if you ever 
have to do any serious maintenance 
programming. The software engineer- 
ing approach greatly simplifies the task 
of correcting or enhancing an existing 
program, especially if someone else 
wrote the original. Take it from some- 
body who's been there. The key word 
is "structure." 

Structured Analysis and Design 

In the olden days, fiowcharts were 
often used for diagramming the logic 
of a computer program. While flow- 
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Sample Data Dictionary Entries 



reaction-data-file = 7 Creacti on-data> 

reaction-data = 16<chemi cal --f armul asJ 

+ nLimber-D-f-reac;tion<5 

+ number-of -sets 

+ 1 Xequation-descri pti on> 16 

equation-description - reaction-number 

+ 4tcDmpound-numbers> 
■t- 4<;coef -f icientsJ 

number-of -sets = C2 141 

English equivalent: The reaction data file consists of 7 blocks 
of reaction data. Each block of reaction data consists of 16 
chemical formulas, the number of unique reactions in tfie set, the 
number of ec^uivalent reacticin sets, and from 1 to 16 blacks C3f 
descriptions of the possible e^quations that can be formed. Each 
equation description consists of a r-eaction sequence number, 
compound numbers for the four compounds in tlte equation, and 
coefficients for the four compounds in the balanced equation. 
There can be either 2 or 4 equivalent reaction sets in eacli 
reaction data block. 



charts are useful tools, they have some 
limitations. For one thing, they imply 
a sequence of events, bj^ indicating how 
control flows from one operation to 
another. This might be okay for di- 
agramming the internals of a module, 
but it doesn't work well for describing 
an overall software system, in which a 
different sequence (or even set) of 
events might take place each time the 
program is executed. 

In the 1970's, several alternative 
methods were devised for so-called 
structured systems analysis and de- 
sign. Many of these concentrate on the 
flow of data within a software system. 
After all, that's what software is all 
about. The most important question to 
ask during the analysis phase is, "What 
is the output of this system supposed 
to be?" The next question is, "What 
data do you need to generate this out- 
put and where does it come from?" 

that we have defined the outputs 
and inputs of the system (in that ord- 
er), everything else is just a matter of 
transforming Input data into output 
data. What could be simpler? 



The most popular diagram used for 
both structured systems analysis and 
design is the "data flow diagram" or 
DFD. A sample DFD is shown in Figure 
1. (The figures are all based on portions 
of an educational chemistry game 1 
wrote once upon a time.) A DFD simply 
illustrates the relationships between all 
the pieces of a system; you shouldn't 
try to infer an5^hing about the se- 
quence in which various processes 
may be executed. 

There are really only four kinds of 
elements in a DFD, each of which must 
be given an appropriate label: 

1. Processes — transform inputs to 
outputs. They are frequently represent- 
ed as circles or rounded rectangles, 
called "bubbles." A process cor- 
responds to a program module or 
group of modules. 

2. Data Stores— repositories of data. 
They are shown as two parallel 
horizontal lines, and correspond to 
flies, databases, or internal variable 
storage. 

3. Externals — entities outside the 
software system that communicate 



with the system, by passing data in or 
receiving data from the system. Exter- 
nals (sometimes called terminators) are 
shown as rectangular boxes. 

4. Data Flows— data that moves be- 
tween stores, processes, and externals. 
They appear in the DFD as lines with 
arrowheads that indicate which way 
the data is flowing. The data flow label 
indicates exactly what data is flowing. 
An unlabeled flow is assumed to have 
the same label as that of the data store 
to which it is connected. 

Data flow diagrams aren't limited to 
software applications. They can just as 
easily be used to represent a system in 
which actual objects, not data, are flow- 
ing from one place (process, external, 
or store) to another. An example is a 
warehouse system, with, say, computer 
parts being moved about. The DFD is 
just a general way to diagram some sys- 
tem, without regard to the hardware or 
language that might ultimately be used 
for implementing a software system. 

A data flow diagram is a "model" of 
the software system you are building. 
That is, it's a visual representation of 
the system that can be used to show 
the purpose of the system, how it con- 
nects to the rest of the world, and what 
components it is made of. The great 
thing about a model is that it's an aw- 
ful lot easier to change the model than 
to change the real thing. Consider a 
three-foot scale model of an aircraft car- 
rier. If you wanted to move the ship's 
island from the starboard side of the 
ship to the port, wouldn't you rather do 
that on the model before you built the 
full-size ship and said "Uh, oh."? 1 
would. 

DFDs are great for facilitating com- 
munication between the people who re- 
quest a software system and those who 
have to create it. In this case, a picture 
is worth at least 1024 words. By obtain- 
ing very early a complete picture of 
what the system is intended to do, you 
are much more likely to come up with 
a final product that makes the user feel 
that his money is well spent. Struc- 
tured analysis and design greatly 
reduce the chance of errors and 
oversights. 

Unless your software system is very 
small, you can't squeeze a complete 
description of it into a DFD that will fit 
on one piece of paper (or one computer 
screen). Whatever shall we do? We'll 
break the problem into several levels, 
with increased detail shown at each 
successive level. 

First, draw a DFD containing only 
one process, representing your entire 
system. This DFD is typically called a 
"context diagram," because it shows 
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* Create and maintain student files, up to 200 
students, 50 marks each, any num. of classes 

* Allows weighting and categories 

* Provides the following types of output: 

- Mark summaries with or without stud, names 

- Statistical analysis summaries with mean, 
median, ranking, breakdown by A's B's etc. 

- Attendance recording sheets 

- Individual student reports with comments 

* Uses dialog boxes to enter and update info, 
move easily through student records using up 
and down arrows. 

* Works with ST or MEGA in monochrome or 
color, any standard printer. 
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your system in the context of the rest 
of the world (all the externals that con- 
nect to the system). Then, use your 
microscope to peer inside that one 
process, and draw a second diagram 
containing several processes, 
representing the principal ftmctions of 
your system. Each of those processes 
might be further expanded, showing 
even more detail, and so on. 

This is the partitioning process I 
mentioned earlier. The ultimate goal is 
to subdivide the processes until each 
process on your lowest-level DFDs 
represents an individual program mod- 
ule that performs a single function. By 
drawing many DFDs at different levels, 
you don't have to try to comprehend 
the entire system by studying one 
mammoth diagram with many sym- 
bols and lines on it. A good rule of 
thumb is to limit each DFD to around 
seven or fewer processes. 

Once you get your DFDs down to the 
module level, another diagramming 
method is used. "Structure charts" 
show the hierarchical relationships 
among modules, as illustrated in 
Figure 2. The structure chart also in- 
dicates the data interfaces between 
modules, by showing what information 
flows from a higher level module down 
to a lower level module and vice-versa. 

Another vital part of the structured 
design is called the "data dictionary." 



How many times have you found that 
you used the same variable name to 
mean two different things in a pro- 
gram, or used different names for the 
same piece of data? Imagine the 
problems that can arise when several 
people are working on parts of the 
same program, with no rules as to what 
to name variables or files, or how large 
arrays should be, or what type of data 
each variable represents. Things can 
get out of control very quickly. It has 
happened to me, folks, and it could 
happen to you. 

The data dictionary is a repository of 
definitions of all of the elements in the 
design, including data flows, data 
stores, processes, and terminators. It 
can avoid the redundancy of using 
different names for the same piece of 
data, errors and inconsistencies in vari- 
able names and characteristics, com- 
munication problems among program- 
mers, and other related bimimers. Of 
course, a data dictionary isn't much 
good if it's incomplete, inaccurate, or 
ignored. Figure 3 shows what some 
data dictionary entries might look like 
using one of the common notations 
(DeMarco's); the details aren't impor- 
tant here. 

Now, we are almost ready to write the 
program modules themselves. But not 
quite. Our data flow diagrams tell us 
what information flows into each mod- 
ule and what flows out, but they don't 
tell us how to accomplish the transfor- 
mation. The missing piece is a detailed 
"process specification," or "minispec." 
This design element describes exactly 
what goes on inside the module, in 
enough detail that now, finally, at long 
last, you can write a computer program 
in the language of your choice. 

Process specifications can take many 
different forms. You have probably 
written them before, using some kind 
of "pseudocode" or "structured En- 
glish" to write out in words exactly 
what you want the program to do. 
Figure 4 shows a process spec written 
in one flavor of pseudocode. Various 
other diagramming techniques can 
also be used, such as action diagrams, 
Wamier-Orr diagrams, and others. It's 
often a short Journey from pseudocode 
or action diagram to actual code in a 
real computer language. In fact, some 
of the available computer-based di- 
agramming tools will actually produce 
compilable source code from the dia- 
grams, but such code generators are 
still pretty much a thing of the future. 

This seems like an awful lot of junk 
to keep track of. Just to write a com- 
puter program. Wait! Let's let the com- 
puter do the grunt work. Yeah, that's 
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the ticket! 

The Case for CASE 

The latest items for your software en- 
gineering toolbox are CASE, or 
computer-aided software engineering 
tools. On one level, these are simply 
graphic editors, usually intended to be 
used on powerful microcomputer 
workstations such as the IBM PC/AT or 
Apple Macintosh. (Did someone say 
"ST?" Nope, not yet. Sorry.) Using a 
mouse, data flow diagrams, structure 
charts, and other diagrams used in 
structured systems analysis and design 
can be drawn. 

But CASE tools are much more than 
simple drawing packages. Any CASE 
program worth its salt can make sure 
that your DFDs and structure charts 
are valid, in that they conform to the 
rules of some established diagramming 
methodology. Of course, it's the user's 
responsibility to heed the error mes- 
sages and correct the diagram. You 
could always ignore the errors, but 
your aircrait carrier will look pretty 
funny if it's missing the flight deck due 
to a design flaw. Does the word "unem- 
ployment" mean anything to you? 

CASE tools can integrate the data dic- 
tionary with the diagrams, automatical- 
ly creating entries in the data diction- 
ary when the DFDs are validated. They 
can detect inconsistencies in the way 
items in the dictionary are used or de- 
fined. They can make sure that each 



DFD is consistent with the related 
DFDs at higher and lower levels. They 
can verify that the data interfaces de- 
fined between modules in your struc- 
ture charts are consistent. Some CASE 
packages can validate the structured 
English or action diagrams used in 
creating your process specifications. 
The overall goal is to reduce errors by 
ensuring that all the necessary parts of 
your design are present, properly de- 
fined, and properly connected. Doesn't 
this seem reasonable? 

Summary 

I hope you don't feel that all this talk 
about engineering is taking the fun out 
of computer programming; it doesn't 
have to. Most of us will always be hack- 
ers at heart, and we'll still spend time 
at the keyboard just typing things in 
and seeing what happens. That's the ar- 
tist in each of us, fighting to get out and 
express himself electronically. 

The main application for software en- 
gineering ideas, methodologies, and 
tools is in the world of larger-scale 
(usually commercial) software develop- 
ment, where projects tend to be in- 
creasingly complex and time- 
consuming. 1 think you'll agree that a 
free-form approach to serious program 
development isn't likely to be as suc- 
cessful as a more disciplined, systemat- 
ic approach, particularly when sever- 
al (or many) people are involved. Con- 
temporary software products are ex- 



pensive, they stick around for a long 
time, and they undergo continual re- 
vision and enhancement. 

As an example, I'm writing this arti- 
cle using ST Writer version 2.0. How 
many versions of this popular program 
has the good Dr. Noonan released to the 
Atari world? If Dr. Noonan didn't 
receive a structured design for ST 
Writer from the original programmers, 
1 suspect he wishes he had by now. 
Software engineering can help prevent 
your program from ultimately becom- 
ing a crazy quilt of patch on kluge on 
repair on modification on correction. 
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Figure 4. Sample Process Specification in Pseudocode 



Procedure: Find Equation 



Compare first compound number in equation with -first compound number 

for all equations in set 
If no match 

then call Error-Routine 
else if match then do 

compare other compound numbers in equation with those in 

entry matched 
if no match 

then call Error-Routine 
else if match 
then do 

get reaction number for matched entry 
if reaction number already complete 
then do 

print "Already Done" message 
make error sound 
reset screen 
end da 
end if 
end do 
end i f 
end do 
end if 
return 



Procedures Error-Routine 

print "Incorrect Reaction" 

make error sound 

reduce score by 5 points 

reset screen 

return 
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HARDWARE 



The Hard Drive Construction Project 



by Andy Eddy 



Since purchasing my ST, I've want- 
ed to get a hard drive to make storage 
easier and neater, provide faster access 
to the growing list of software I use, and 
to help eliminate the desert of floppies 
that surrounds my computer "office." 
The latter threatens to spread into my 
family's precious living space, but, un- 
fortunately, hard drive cost was a 
major limitation regardless of the over- 
all benefits it would bring. 

One thing in my favor — and we've 
said it before — is that as computers be- 
come more popular, the equipment 
that was once at a premium (like mod- 
ems and hard drives) becomes more 
commonplace. The driving force be- 
hind this movement comes from mass 
production pushing the prices down; 
and that situation had taken hard drive 
prices lower, but not enough for my 
liking. 

Still another method that people are 
using to lower costs is through do-it- 
yourself construction— an option that 
is becoming especially popular in the 
IBM-compatible world — giving the user 
the freedom to configure a system to 
his or her own specifications and 
budget. 

Unfortunately, I never thought home 
construction of a hard drive system 
was a viable alternative for the ST; that 
is, untU 1 heard about a company called 
Berkeley Microsystems (360 Oakland 
Avenue, Suite 5, Oakland CA 94611; 
(415) 465-6956). They've advertised in 
ST magazines and shared booths at 
some Atari Faires, demonstrating their 
method of using readily-available, IBM- 
compatible parts in union with their 
interface card to build an inexpensive 
alternative to the over-the-counter 
commercial drives. 

I've done my share of Ileathkit 
projects in the past and resolved that 
this might be the answer to my pray- 
ers: a low-cost way of getting that hard 
drive. So 1 contacted Berkeley for more 
information, and they sent me a copy 
of their manual, as well as some of the 
previous press they've received. With 
this glimmer of hope (and potential sav- 
ing of greenbacks), the dream of the 
Frankendrive sprang into action. 

Looking through the documentation, 
I figured it would be pretty easy to pull 
the job off. The manual lists (to assist 
in the configuration process once your 
construction is completed) various 
drives that match the parameters of 
their product, which is basically any 
ST506/ST412-compatible drive. If you 
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are at all confused by what I Just said, 
then I recommend you take some time 
to shake hands with Tom Marker's 
Hcird Disk Primer, from the May 
1987 ANALOG. It'll be invaluable in 
providing answers to basic questions 
that may arise. 

Igor, get me a screwdriver. . . 

Now, on to gathering the parts for the 
Franicendrive. 1 decided to purchase 
new products in order to ease my fear 
of buying pre-owned materials; this 
strategy goes well for some, but my 
poor luck in the past with used cars 
backed up my plan. Scouring a couple 
of issues of Infoworld and Computer 
Shopper — the latter a magazine 
renowned for its wealth of hardware 
distributor ads— I came up with lots of 

Spreading all 
the parts out 
in front of 
me, I figured 
it would take 
very little 
time to finish 
Franicendrive 

pricing data, as well as some leads for 
the purchases themselves. 

What 1 managed to do is purchase a 
Seagate 8T238 (a 30MB RLL drive), an 
IBM-like case for housing the equip- 
ment, and an IBM-like 150-watt 
switched power supply to drive it all. 
The power supply mounts in the case 
perfectly (which comes with pre-drilled 
screw holes and a custom cutaway for 
the power switch), and also has a built- 
in fan for pulling the generated heat 
out of the enclosure. Some would say 
that a case that size and 150 watts are 
overkill, but I'll address those com- 
ments later. 

Add to this the Berkeley interface 
card and Adaptec 4070 RLL hard disk 
controller, both provided by Berkeley 
(the RLL combo costs $300, while the 
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MFM set-up goes for $250). See Table 1 
for the pricing breakdown, which 
doesn't include incidental shipping 
costs; unfortunately, there are no bar- 
gain computer shops near me, so mail- 
order was a necessity. And to make it 
all the more satisfying, the Berkeley 
unit comes with a built-in clock for set- 
ting the system clock. When you con- 
sider that you'd have to kick out an ad- 
ditional $50 or so for that item else- 
where (excepting Mega owners, who 
have their clock built-in), you can call 
that a further savings over most com- 
mercial hard drives. 

Spreading all the parts out in front 
of me, I figured it would take very lit- 
tle time to finish the Frankendrive. 
A bit hasty in my optimism, I followed 
the somewhat thin directions in the 
Berkeley manual, taking the interface 
and mounting it on top of the con- 
troller and combining them into one 
board set. Even though it isn't recom- 
mended—I found out later that this is 
for reasons of RF crosstalk, an interfer- 
ence which could cause excessive read 
errors — 1 also mounted the board com- 
bo on the hard disk to make one com- 
pact unit. My problem came from not 
being able mount this lump of electron- 
ics inside the case properly. Placing it 
one way would interfere with the clos- 
ing of the case cover: placing it upside- 
down would make mounting it with 
the existing screw holes nearly Impos- 
sible. Time for a reassessment of my in- 
itial strategy. 

As you might have noticed, I was 
winging it from the start, but with so 
much room in the case, 1 didn't figure 
it would be a problem (see The Lesson 
Learned). So 1 removed the board set 
from the drive and aimed for mount- 
ing them side-by-side. Everything fell 
together smoothly; the screw holes in 
the boards and drive matched the case, 
so 1 socked them down. When 1 at- 
tempted to plug all the required cables 
together, the data cable that ran from 
the boards to the drive came up a little 
short. Once again. 1 disassembled the 
whole thing and restarted. 

Still reasonably clearheaded though, 
1 followed that disappointment by 
switching the locations of the drive and 
board set, then placed the power sup- 
ply in its proper location at the right 
rear where the switch cutaway is. 
Again, I tightened them all in place. 
And once again. The Lesson Learned 
came back to nudge me— but 1 hadn't 
picked up on it yet. On one hand, the 



TABLE 1 



COST BREAKDOWN 



BERKELEY PACKAGE (RLL) .. 
30 MB HARD DISK DRIVE ... 

CASE 

POWER SUPPLY ...... 

EXTRA POWER CABLE 



TOTAL COST 



*300 
$265 

* 24 
$ 40 

* 7 



$636 




power supply cables that provide Juice 
to the controller and drive reached 
fine; disheartenlngly though, the cable 
to the Berkeley board came close 
enough to touch its mate, but wouldn't 
s-t-r-e-t-c-h sufficiently to connect. 

In wimpy frustration, I gave a call to 
Berkeley for suggestions. The fellow I 
reached, Vance Chin, told me the best 
thing 1 could do at that point was to 
hook everything up and be sure it 
worked before going through the 

Igor, get 



screwdriver! 

process of anchoring the parts and 
risking further annoyance by having 
to remove them again should there be 
a problem (other than operator error). 
This is when The Lesson Learned final- 
ly sunk in and became reality: Don 't 
screw down the parts until you are 
sure that their location is permanent. 

After purchasing an extender power 
cable, 1 took Vance up on his idea, 
hooking all the cables in their proper 



FIGURE 



sockets and insulating circuit boards 
from shorting on other metal parts. 
Then came the first crucial test: power- 
ing up the system, apart from the ST 
first. . .just in case. Flipping on the 
power switch didn't bring on a show- 
er of sparks or flames, and rewarded 
me with the whirring of the drive com- 
ing up to speed. LEDs blinked and then 
dimmed as the Frankendrive sig- 
naled its readiness for action. 

It's Alive . . . 

This brought on the really crucial 
test: hooking it up to the ST and see- 
ing if the transplant would be success- 
ful or rejected. 1 first took the DMA ca- 
ble (the length of which 1 will discuss 
shortly) and plugged it into the hard 
drive port on the rear panel of the ST, 
then repowered the Frankendrive as 
before. After it went through its rou- 
tine, 1 gingerly placed my finger on the 
ST's switch and rocked it on. Like the 
expectant father who is told his wife 
has just given birth, I was blessed vrttYi 
a bouncing baby bundle of bytes — 
though similarly undiapered and un- 
trained, so to speak. 

For this reason, the next procedure 
was to configure the drive for interac- 



32 



July 1988 ST-Leg 



150W 
POWER SUPPLY 
W/ FAN 



SEAGATE 
30 MB 
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HARD DISK 



INTERFACE 
BOARD 
AND 
RLL 
CONTROLLER 



INTERNAL MOUNTING OF EQUIPMENT WITHIN THE CASE. 



tion with the computer system, and the 
Berkeley package comes with a floppy 
for taking care of all the processes you 
need to undertake before putting your 
hard drive to work. This software lets 
you set up your system for the specif- 
ic drive you are using, so it's prepared 
with such facts as number of cylinders, 
heads, step pulse rate, and other perti- 
nent figures. Using a text editor that 
pumps out ASCII text, it's easy to alter 
their configuration file to match your 
disk's parameters (using the 
previously-mentioned table in the 
manual for assistance). 

Once that simple process was com- 
pleted, it was on to the formatting and 
partitioning process. Just like a floppy, 
the hard disk needs to be formatted to 
break it into smaller blocks for the ST 
to easily digest. Given that your drive 
is quite sizable, you must also partition 
it into several smaller drives to allow 
quick access time to all your data. Due 
to GEM limitations, the ST can address 
a partition no larger than 16MB; I have 
mvrve divided into four drives: two of 
10MB each, and two of 5MB each. This 
process also marks any bad sectors you 
may have on your disk, so the system 
doesn't try to store data to them. It's a 



lengthy procedure, but necessary for 
the sure use of the hard drive. 

As you can see from Figure 2, my 
drive is together in the sense that I can 
move it without the worry of parts fall- 
ing off, but I still need to make the 
Frankendrive more permanent. The 
main problem I face is with the rout- 
ing of the DMA cable, currently snak- 
ing out the front disk drive opening. 
Berkeley provides a cable that is fairly 
short— they claim that this is to meet 
Atari specifications and assure quality 
data transfer over the DMA line — but 
for an installation of this nature, you'll 
wish there was a better way to handle 
it. If I can't get a longer cable (Supra is 
reportedly shipping longer cables with 
their drives), I'll drill a hole in the front 
of the case for the DMA cable, which 
will also give a certain amount of strain 
relief for the cable's connectors. 

The Bottom Line 

Again referring to Table 1, the final cost 
of my Frankendrive was about $635, 
as opposed to the cheapest commercial 
unit that I've seen advertised in ST-Log, 
which was listed at just over $750. I 
figure the money I saved was adequate 
payment for the aggravation I caused 



myself and the phone calls I made. 
Also, the pleasure of doing it myself is 
something to keep in mind, but pride 
and accomplishment can't be meas- 
ured in the same sense as cold hard 
cash. 

The best thing about building the 
Frankendrive is how much is left 
open for expansion, as there is plenty 
of empty space remaining. Chin sug- 
gests that a second ST floppy drive can 
be mounted in the open space, making 
an especially compact unit for trans- 
port. Similarly, someone who uses an 
IBM-compatible, 5 V4-inch drive (such 
as with PC-Ditto) could put that in in- 
stead, or as an added bonus. 

My plan is to later add a second hard 
drive unit, as the Adaptec 4070 con- 
troller can address two drives. This way 
I can double my storage for very little 
expense: the cost of another drive and 
associated cables, or about $290 to dou- 
ble my storage capacity to 60MB. This 
provides an even more substantial sav- 
ings over the high-capacity commercial 
systems that are available; my 60MB 
Frankendrive would end up costing 
approximately $925, far less than com- 
mercial units. 

Final Note 

Shortly after ordering all the parts 
for the Frankendrive, I spoke to 
some other ST users on Delphi who 
had realized even more savings over 
mine. Clarence Chang (CTCHANG) and 
Wayne Dunham (WA'inSTEDUNIlAM) 
purchased Tulin 30MB RLL drives 
directly from the company for their 
construction projects, which they 
managed to And for about $225. That 
brings up the importance of shopping 
around before you buy. I searched for 
some time to find what I found, and 
even then there were better ways to cut 
costs. Supra and ICD, two established 
providers to Atari users, also in- 
troduced their versions of the interface 
building block to give you some choice 
in creating your own Frankendrive. 

Most importantly, be careful not to 
deal with companies that you or other 
users aren't too sure of Mail order buy- 
ing can be risky, so check into each 
firm that you plan to buy through, so 
you don't get burned. 

The author resides in Connecticut, and 
is a frequent contributor to ANALOG and 
ST-LOG. He can be reached on Delphi 
and GEnie as KIDX; on People/Link as 
KID X; and Compuserve at 72327,503. 
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CIRCLE #109 ON READER SERVICE CARD. 




Any 
Resolution 

by Matthew J.W. Ratcllff 



Ilumm, let's log on to Gateway BBS and 
see what's cooking. 
ATDT 314-647-3290 
CONNECT 

Welcome to Gateway BBS. 
PASSWORD: xxxx 

Enter the last four digits of your phone 
number: xxxx 

Last time on: 7/20/87 3:00AM 
Logon: 7/21/87 3:30AM 

G0> z;2:r;n 

Welcome to Hatty's Rap; you have 100 

messages waiting. 

MSG: 29567 Date: 7/21/87 

From: Jim* Gateway 

To: Mat 'Rat 

Subj: Where's the STUFF 

lley, Mat, Where are all the articles for the 
August ACE Newsline? You'd better get to 
work pronto, if you want to remain 
Sysop. I made you, 1 can BREAK you! 
<GRIN> 

Big JIM 

Oh, wow, I can see this is going to be 
a long session; 100 new messages and 
then I've got to get all those articles done. 
Well, it's time for a Bud break before get- 
ting too deeply into this. A quick dash to 
the fridge, load up another video game for 
Nathan, change Charlie, kiss Nancy and 
assure her I'm still alive, turn the steaks 
on the grill and take a restroom break. 
Ok, back to the computer; 



Input too slow. Timed out. Goodbye, 
Mat'Rat, thanks for calling. < CLICK > 

CARRIER LOST 

Oh, drat! 

ATDT 314-647-3290 
BUSY 

If you are active in telecommunica- 
tions, as I am, you may find the above a 
rather typical access session. Most bulle- 
tin board systems (BBS) have an automat- 
ic timeout feature, and if you don't enter 
something at your keyboard within one 
minute or so you are automatically logged 
off. Commercial systems such as Delphi 
or CompuServe are more forgiving, but 
you pay the price, of course. 

Now all you need is the Busy Buddy 
accessory. To create your copy of Busy 
Buddy, type in Listing 1 (checking your 
work with ST-check) and run it from ST 
BASIC. Install BUSYBUD.ACC on your 




telecommunications boot disk, and you 
are In business. Whenever you need to 
take a break, just pull down the desktop 
menu (which is accessible from most 
communications programs now) and 
click on Busy Buddy. When activated 
an alert box will come up, prompting you 
for backspace type. Normally an ASCII 8 
is required, but some systems expect a de- 
lete character, ASCII 127. If you are call- 
ing 8-bit Atari boards using AT ASCII emu- 
lation, then you should click on the mid- 
dle selection, ASCII 126, what the 8-bit 
uses for a backspace (the ST and other 
computers use ASCII 126 as a tilde). Click 
on the appropriate one (or just press 
RETURN to accept ASCII 8). 

The next alert box is a prompt for the 
maximum time limit that Busy Buddy 
should run unattended, Ave, 15 or 60 
minutes. This feature will save your neck 
if you put Busy Buddy to work on a pay 
connect system, or a long-distance BBS. 
Since Buddy will time out for you even- 
tually, you'll get logged off the BBS soon- 
er or later if you completely forget about 
it. When the Buddy times out, another 
alert box will pop up. It gives you the op- 
tion of restarting (put in a new time limit), 
or exit. 

Once Busy Buddy is active, you will 
see the send and receive lights on your 
modem pulsate about once every two se- 
conds. Buddy is sending a space and then 
a backup (either backspace or delete) 
character once every half second. This 
will keep the system at the other end 
from timing out and hanging up before 
you've used all your access time. 

With Busy Budy running, you can go 
to the Flash or Interlink edit buffer and 
compose your messages, for example. Or 
take a seventh-inning stretch and fetch 
a cold brew. When it's time to get back 
to modeming, just pull down the desktop 
menu and click on Busy Buddy again. 
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The timer routine will be shut off, and a 
reminder displayed to that effect. 

I've been testing Busy Buddy 
thoroughly, with no problems, on Delphi, 
ST Forem (AURA in St. Louis) and 8-bit 
Forem (Gateway BBS). One real plus is 
that Busy Buddy is automatically disa- 
bled whenever you exit the menu screen 
to the terminal display. Buddy is active 
when GEM is active, in the edit windows, 
menus, and file selectors of these termi- 
nal programs. You should never attempt 
a file transfer without disabling Busy 
Buddy first, however. When you initiate 
the transfer, a file selector (GEM window) 
pops up, and Buddy is enabled once 
again. It truly confuses any Xmodem 
transfer. Simply go back to the Busy 
Buddy entry under the Desk menu and 
click it off, then all your file transfers will 
work smoothly. 

This utility is extremely useful when it 
comes to message entry on BBS and 
Telecommunication services. While Bud- 
dy does his thing keeping the Forem 
board I'm connected to busy, I can use 
full screen editing in my Flash or Inter- 
link buffer to generate a reply. 

Bud takes a clicking and keeps on tick- 
ing too. I used Interlink to connect with 



Gateway, began to enter a message, and 
then enabled Busy Buddy. Once on, I 
used Interlink's EXECUTE feature to load 
and run Flash. In Flash I created my re- 
ply, and then used ASCII upload to send 

Kiss Nancy 
and assure 
her l^m still 
alive, turn 
the steaks on 
the grill and 
take a 
restroom 
break. 



the message. All the while, except during 
some file I/O, Busy Buddy kept on run- 
ning. You will find this utility helpful 
when you need to exit your terminal soft- 
ware to format disks (something Flash 
doesn't do), or perform other file main- 
tenance functions. 

This certainly isn't the most powerful 
accessory you will ever use, but it can 
come in quite handy if you spend a lot 
of time on the modem. Study of the heav- 
ily commented listing will show you how 
to write an accessory in C. Written with 
Megamax, the only other "special" thing 
required is linking this file with ACC.L 
(the ACC.L must be tirst in the link list), 
which comes with the compiler package. 
(Note the use of the external global varia- 
ble gl apid, vital information for your 

accessory.) 

The evnt_multi function is used in- 
stead of the usual evnt msg so that 

either the accessory open message or a 
two-second timed interrupt "event" can 
activate Busy Buddy. The state of the 
flag variable tells the program to activate, 
deactivate, or continue the busy signal 
process in Busy Buddy. 

The next time you are on line. Busy 
Buddy will be there to help you out. 



Listing 1; 
ST Basic 



186 f ilenane$="a:SBUSVBUD.ACC" 

lie fullu 2:clearw 2:gotoxy e,e:print 

"creating f ile. . ." 

120 option base 6 

125 din aX(168ee) :def seg=l:u$="" 

130 prvarptrCaXCei] :bptr=p+i 

for i>'.=l to 4354 
150 read u$ : codeK=val C"SH"+v$] 
160 poke p, codeJC: print 
170 p=p+l 
180 next 

190 bsave f i lenane$, bptr, 4354 



200 print 
1888 data 
4,88,08, 18 
1818 data 
8, 88, 88, 4E 
1828 data 
A, FF, FE, OC 
1838 data 
C, 88, 88,81 
1848 data 

C, 28, 2D, 00 
1058 data 

D, 88, 18, 28 
I860 data 
D, 80, 10, D9 
1878 data 
D, 00, 08, 4E 



"file written": 
66, 1ft, 80,00, 10, 
,04,68,68 
66, 66, 06, 60, 68, 
,F9, 66,88 
6e,eC, 4E,F9, 88, 
, 6D, 4E, F9 
FF,Ffl, 66, 84, 5D, 
, 60, 20,6D 
68,18,22,60,68, 
,14,53,86 
6F,e6, 13, 28,51, 
, 2I>,66,1C 
53,88,42,18,51, 
, ED, 68, IC 
29, 4D, FF, FC, 4F, 
, AD, 66, 66 



end 

BC, 88, 60, 00,2 
68,88,68,86,8 
68, eC, 86, 4B,F 
8D,66,F4,9B,F 
18, D3, ED, 66,1 
C8, FF,FC, 28,6 
C8,FF, FC,28,6 
EC, FF, FC, 2A,6 
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1688 data 4E, BA, 08, 2A, 3F, 3C, 66. 66, 4E, B 
ft, 66,C6, 48,E7, FF, FE 

1696 data 3F, 3C, 66, 41, 3F, 3C, 68, 82, 4E, 4 
1, 58,8F, 26, 3C, 66, SF 

1168 data 42, 48, 53, 88, 66, FC, 4C, DF, 7F, F 
F, 4E,75, 4E, 56,FF, E6 

1116 data 4E, Bft, 85, 6E, 48, 6C, 66, 66, 3F, 2 
C,EE,7A,4E,BA,86,62 

1126 data 5C, 8F, 3D, 46, FF, FE, 3D, 7C, 66, 1 
8,FF,E8, 3D,7C,68,61 

1136 data FF, E6, 66, 88, 68, E8, 42, 6E, FF, E 
C, 48,6E,FF,EC, 48, 6E 

1148 data FF, EC, 48, 6E, FF, EC, 48, 6E, FF, E 
C, 48,6E,FF, EC, 48, 6E 

1156 data FF, EC, 42, 67, 3F, 3C, 67, 08, 48, 6 
E,FF,EE,3F,2E,FF,EC 

1166 data 3F, 2E, FF, EC, 3F, 2E, FF, EC, 3F, 2 
E,FF,EC,3F,2E,FF,EC 

1176 data 3F, 2E, FF, EC, 3F, 2E, FF, EC, 3F, 2 
E,FF,EC,3F,2E, FF, EC 

1188 data 3F, 2E, FF, EC, 3F, 3C, FF, FF, 3F, 3 
C,FF,FF,3F,3C,FF,FF 

1198 data 3F, 2E, FF, E8, 4E, BA, 64, DE, DE, F 
C, 66, 3C, 3D, 48, FF, EA 

1266 data 36, 2E, FF, EA, C6, 7C, 68, 16, 67, 8 
6, 88,44, 6C,6E, 88, 28 

1218 data FF, EE, 66, 88, 66, 3A, 38, 2E, FF, F 
6, B6,6E,FF, FE, 66, 66 

1226 data 88, 2E, 38, 2E, FF, E8, C6, 7C, 66, 2 
6, 67, 88, 86, 14, 3D, 7C 

1236 data 86, 18, FF, E8, 4E, BA, 68, E4, 42, 6 
E,FF,EA,68, 88,66,16 

1246 data 3D, 7C, 66, 36, FF, E8, 4E, BA, 86, 4 
2,42,6E, FF, EA, 38, 2E 

1258 data FF, EA, Ce, 7C, 66, 28, 67, 86, 68, 2 
4,36,2E,FF,E8,C8,7C 

1266 data 88, 26, 67, 88, 88, 18, 4E, BA, 66, E 
8, eC, 6C, 86, 88, EF, 88 

1278 data 6E, 68, 88, 8A, 4E, BA, 61, 38, 3D, 4 
8, FF,E8, 38, 2E, FF, E6 

1288 data 66, 66, FF, 14, 4E, 5E, 4E, 75, 4E, 7 
5,4E,56,FF,FE,48,6C 

1298 data EF, B4, 3F, 3C, 88, 61, 4E, BA, 85, 8 
6,5C,8F,3D,48,FF, FE 

1366 data 36, 2E, FF, FE, 68, 68, 68, 62, B8, 7 
C, 86, 81, 67,68,86,86 

1318 data 68, 66, 68, 18, 19, 7C, 88, 88, EF, 8 
A, 66,66,68,46,68,86 

1326 data 68, 8E, 88, 7C, 88, 62, 67, 86, 88, 6 
6, 66, 66, 88, 16, 19, 7C 

1336 data 86, 7E, EF, 6A, 68, 88, 88, 2C, 66, 6 
6,66,eE,Be,7C,88,e3 

1346 data 67,88,86,66,66,88,88,18,19,7 
C, 66, 7F,EF, 6A,68, 66 

1356 data 86,12,68,66,88,82,68,86,88,8 
A, 68, 66,66,86,66, 86 

1366 data FF, F6, 4E, BA, 61, 22, 3F, 3C, 86, 2 
8, 4E,BA, 86,7C, 54, 8F 

1376 data 19, 6C, EF, 6A, EF, 8C, 4E, 5E, 4E, 7 
5, 4E, 56,86, 88, 18, 2C 

1386 data EF, 8C, 12, 2C, EF, 8A, 48, 81, 48, 8 
6,68,41,66,86,68,18 

1396 data 16, 2C, EF, SC, 48, 88, 3F, 88, 4E, B 
A, 88, 4E, 54, 8F, 48, 6C 

1468 data EF, 8C, 3F, 3C, 88, 61, 4E, BA, 84, 5 
6,SC, 8F,4E,SE,4E,75 

1416 data 4E, 56, 86, 68, 18, 2C, EF, 8C, 48, 8 
6,3F,e6, 4E, BA,88, 2A 

1426 data 54, 8F, 18, 2C, EF, 8C, 48, 88, B8, 7 
C,88,28,66, 88, 88, 6C 

1436 data 19, 6C, EF, 6A, EF, 8C, 68, 88, 86, 8 
8, 19, 7C, 86, 28, EF, 8C 

1448 data 53, eC, EF, 68, 4E, 5E, 4E, 75, 4E, 5 
6,66, 66, 18, 2E, 68, 69 

1456 data 48, 86, 3F, 88, 3F, 3C, 88, 81, 3F, 3 
C, 86, 63, 4E, BA, 87, 5C 

1466 data 5C, 8F, 4E, 5E, 4E, 75, 4E, 56, FF, F 
C, 16, 2C, EF, eC, 12, 2C 



1476 data EF, BA, 48, 81, 48, 88, BO, 41, 66, 8 
8, 88, 16, 16, 2C, EF, BC 

1486 data 48, 88, 3F, 88, 4E, BA, FF, C2, 54, 8 
F,3F,3C, 86,67, 3F,3C 

1498 data 88, 82, 3F, 3C, 86, 83, 4E, BA, 87, 2 
2, 5C, 8F, 48, 6C, EF, 8E 

1566 data 3F, 3C, 88, 81, 4E, BA, 63, B8, 5C, 8 
F,3D, 4e,FF, FE,eC,6E 

1516 data 88, 61, FF, FE, 66, 86, 68, lA, 3D, 7 
C,66, 16,FF,FC,48,6C 

1528 data EF, 8C, 3F, 3C, 88, 81, 4E, BA, 83, 9 
6,5C, 8F, 68, 86, 86, 6C 

1536 data 3D, 7C, 86, 38, FF, FC, 4E, BA, 88, 6 
E,38, 2E, FF, FC, 68, 68 

1548 data 86, 62, 4E, 5E, 4E, 75, 4E, 56, FF, F 
E,48,6C,EF,48, 3F, 3C 

1558 data 86, 83, 4E, BA, 83, 6A, 5C, 8F, 3D, 4 
8,FF,FE,36,2E,FF, FE 

1566 data 68, 88, 86, 82, B8, 7C, 68, 81, 67, 8 
8,66,86,68, 86,68,18 

1576 data 39, 7C, 88, 96, EF, 88, 68, 66, 88, 4 
6, 66, 66,66, 6E, B6, 7C 

1586 data 86,62,67,68,66,86,66,68,88,1 
6, 39, 7C, 81, C2, EF, 88 

1598 data 68, 88, 68, 2C, 68, 88, 68, 8E, B8, 7 
C, 88, 83, 67,68,88,86 

1668 data 68, 86, 66, 18, 39, 7C, 87, 88, EF, 8 
8,66,68,68, 12,68,68 

1616 data 68, 82, 66, 88, 88, 8A, 68, 88, 88, 8 
6, 66,68,FF,F6, 4E, 5E 

1628 data 4E, 75, 29, 49, E7, 44, 29, 4A, E7, 4 
8, 22, 2F, 88, 64, 36, 3C 

1638 data 86, C8, 4E, 42, 22, 6C, E7, 44, 24, 6 
C, E7, 46, 4E, 75,88,81 

1646 data 68,82,61,81,82,81,61,88,61,8 
1,62,61,61,81,81,81 

1658 data 88,68,88,88,68,68,68,88,66,8 
6,81,66, 88,61, 86, 83 

1666 data 65,88,65,65,86,88,61,61,82,8 
1,66,18,67, 81,82,61 

1676 data 86,68,66,88,88,86,68,66,66,8 
8,81,81, 81,82, 61,81 

1686 data 62,81,81,82,81,81,61,81,62,8 
1,81,61, 86,68, 88,86 

1698 data 68,86,88,68,68,88,68,88,62,6 

1.61.61.61.61, 86,61 

1788 data 81,64,81,81,81,83,81,82,81,6 
1,84, 82,61,88,81, 81 

1716 data 88,88,86,86,86,86,81,81,81,6 
9,61,61, 81,81, 81,81 

1728 data 61,86,66,65,61,83,83,61,62,8 
2,61,68,88,68, 86,86 

1738 data 68,88,88,88,68,86,86,68,68,8 
8,66,68,88,68,88,68 

1748 data 88,88,68,88,88,88,86,88,88,8 
8,66, 68,88,88,88,68 

1758 data 86,88,64,63,68,88,83,68,86,6 
1,66, 88,61, 86,68,61 

1768 data 86,84,81,81,83,81,61,86,65,8 
8,81,81,61, 86,65,68 

1776 data 88,81,81,86,81,81,88,88,88,8 
6,88,66, 86,88,86,86 

1786 data 88,86,68,88,68,68,86,66,66,8 
6,66,68,88,88, 88,82 

1798 data 82,68,88,88,88,68,88,88,88,6 
6,66,66,88,88, 86,68 

1888 data 88,68,86,88,68,86,66,68,86,6 
6,88,86,85,81,86,85 

1818 data 81,88,81,81,86,81,81,88,82,8 
5,68,86,81,88,62, 81 

1826 data 68,81,81,88,86,85,88,88,66,0 
6,66,61,81,68,81,88 

1836 data 82,61,86,82,81,61,81,81,61,8 
6,08,86,88, 88,68,88 

1846 data 68,88,88,88,86,88,88,86,88,8 

1.62.83.81.62, 81,81 

1856 data 81,81,61,81,68,81,81,68,81,8 
2,4E,56,FF, FA, 39, 6E 
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1868 data 08, 88, EE, FE, 30, 2E, 08, 88, 90, 7 
C, e8,8A,Cl, FC, 88, 83 

1870 data 41, Fft, FE, 8C, 22, 08, 20, 41, DO, C 
8,41, DO, 2D, 48, FF, FA 

1880 data 3D, 7C, 08, 81, FF, FE, 60, IE, 20, 6 
E, FF, FA,52, AE, FF, FA 

1890 data 10, 10, 32, 2E, FF, FE, E3, 81, 41, E 
C, EE, FE, DO, CI, 48, 80 

1900 data 30, 80, 52, 6E, FF, FE, OC, 6E, 00, 0 

4, FF, FE,6D, DA, 2F, 2C 

1910 data EE, 7C, 4E, BA, FE, 2E, 58, 8F, 30, 2 
C,EE, AC,4E,5E,4E,75 

1920 data 4E, 56, FF, FE, 41, EC, EE, FE, 29, 4 
8, EE, 80, 41, EC, EE, DE 

1930 data 29, 48, EE, 84, 41, EC, EE, BC, 29, 4 
8, EE, 88, 41, EC, EE, AC 

1940 data 29, 48, EE, 8C, 41, EC, EE, AO, 29, 4 
8, EE, 90, 41, EC, EE, 98 

1950 data 29, 48, EE, 94, 41, EC, EE, 80, 29, 4 
8, EE, 7C,3F, 3C, 88, 8A 

1960 data 4E, BA, FF, 58, 54, 8F, 39, 6C, EE, A 
C,EE,7A,30,2C,EE,7A 

1970 data 4E, 5E, 4E, 75, 4E, 56, 00, 00, 39, 6 
E,ee,88,EE, BC, 39, 6E 

1980 data 00, OA, EE, BE, 39, 6E, 00, 8C, EE, C 
0, 39,6E,0O, 8E, EE,C2 

1990 data 39, 6E, 00, 10, EE, C4, 39, 6E, 00, 1 
2,EE,C6,39,6E, 00,14 

2000 data EE, C8, 39, 6E, 00, 16, EE, CA, 39, 6 
E, 0e,18,EE,CC, 39, 6E 

2010 data 00, lA, EE, CE, 39, 6E, 00, IC, EE, D 
0,39, 6E,00, 1E,EE, D2 

2020 data 39, 6E, 00, 20, EE, D4, 39, 6E, 00, 2 
2, EE, D6,29,6E, 00,24 

2030 data EE, AO, 39, 6E, 00, 28, EE, D8, 39, 6 
E, 00, 2A,EE, DA, 3F, 3C 

2040 data 00, 19, 4E, BA, FE, D6, 54, OF, 20, 6 
E,eO,2C,38, AC,EE, AE 

2050 data 20, 6E, OO, 30, 30, AC, EE, BO, 20, 6 
E, 00, 34, 30, AC, EE, B2 

2060 data 20, 6E, 00, 38, 30, AC, EE, B4, 20, 6 

E, 00, 3C,30, AC, EE, B6 

2070 data 20, 6E, OO, 40, 30, AC, EE, B8, 30, 2 
CEE, AC,4E,5E,4E,75 

2080 data 4E, 56, 00, 00, 39, 6E, 00, 08, EE, B 
C, 29, 6E,00, OA, EE, AO 

2090 data 3F, 3C, 00, 23, 4E, BA, FE, 84, 54, 8 

F, 4E, 5E,4E, 75, 4E, 56 

2100 data 00, 00, 39, 6E, 00, 08, EE, BC, 29, 6 
E, 00, OA,EE, AO, 3F, 3C 

2110 data 00, 34, 4E, BA, FE, 66, 54, OF, 4E, 5 

E, 4E, 75,4E,56, 00, 00 

2120 data 3F, 2E, 00, 08, 4E, BA, 02, CA, 54, 8 

F, OC, 6E,83, 00, 00, 08 

2130 data 6E, 06, 30, 3C, 00, 00, 60, IE, 3F, 2 
E, 00, 08, 3F, 3C, 00, 3E 

2140 data 4E, BA, 03, 34, 58, 8F, 39, 40, E8, 7 
8, 67, 06,30, 3C, FF, FF 

2150 data 60, 04, 30, 3C, 00, 00, 4E, 5E, 4E, 7 

5, 4E, 56, 00, 00, 3F, 2E 

2160 data OO, 08, 3F, 3C, 00, 4C, 4E, BA, 03, 0 
E,58,8F,4E,5E,4E,75 

2170 data 4E, 56, FF, FE, 2F, OB, 41, EC, E8, C 
6,26,48,60,16,30,20 

2180 data 00, OA, C0, 7C, 00, 03, 67, 08, 2F, 0 
B, 4E, BA,00, 2A, 58, OF 

2196 data D6, FC, 00, 14, 20, OB, 41, EC, EO, C 
6,22,08,D2, BC, 00, 00 

2200 data 05, B4, BO, 81, 6D, D8, 3F, 2E, 00, 0 
8.4E, BA,FF,AE, 54, 8F 

2210 data 26, 5F, 4E, 5E, 4E, 75, 4E, 56, 00, 0 
0, 2F, OB, 26, 6E, 00,08 

2220 data 2F, OB, 4E, BA, 00, 44, 50, 8F, 4A, 4 
0,67, 06, 30, 3C, FF, FF 

2230 data 60, 30, 30, 2B, 00, OA, CO, 7C, 00, 1 
0,67, OA, 2F, 20,00,06 

2240 data 4E, BA, 01, FO, 58, 8F, 42, 6B, OO, 0 
A, 3F,2B,00, OC, 4E, BA 



2250 data FF, 2C, 54, 8F, 4A, 40, 67, 86, 38, 3 
C,FF,FF,68,O4,30, 3C 

2260 data OO, 00, 26, 5F, 4E, 5E, 4E, 75, 4E, 5 
6, 00,00,40, E7, 81, 18 

2270 data 26, 6E, 00, 08, 30, 2B, 00, OA, CO, 7 
COO, 03,66, 08,30, 3C 

2200 data FF, FF, 60, 00, 00, 90, 2E, 13, 9E, A 
6,00,06,30,20, 00, OA 

2290 data CO, 7C, 00, 88, 67, 56, 38, 2B, 00, 0 
A, CO, 7C, 00,02,66,06 

2308 data 30, 3C, FF, FF, 60, 76, 30, 20, 00, 0 
A, CO, 7C, 00, 04, 67, 10 

2310 data 3F, 3C, 00, 02, 42, A7, 3F, 2B, 00, 0 
C, 4E, BA, 00, 68,50, 8F 

2320 data 3F, 07, 2F, 2B, 00, 06, 3F, 2B, 00, 0 
C, 4E, BA, 02, CC, 50, OF 

2330 data OC, 40, FF, FF, 66, 06, 30, 3C, FF, F 
F, 60, 40, 02, 6B,FF, 7F 

2340 data 00, OA, 30, 07, 48, CO, Dl, AB, 00, 0 
E, 60, 24,0C,6B, 00, 00 

2350 data OO, OC, 6F, IC, 3F, 3C, 00, 01, 30, 2 
0,00,04, 44, 40, 40, CO 

2360 data 2F, 00, 3F, 2B, 88, 8C, 4E, BA, 80, 1 
C, 50, OF, 27, 40, 00, OE 

2370 data 26, AB, 00, 06, 42, 6B, OO, 04, 30, 3 
C,00, 00, 4C, DF, 08, 00 

2380 data 4E, 5E, 4E, 75, 4E, 56, FF, F2, OC, 6 
E, 00, 00, 00, 00, 6C, OA 

2390 data 20, 3C, FF, FF, FF, FF, 60, OO, 00, F 
E,3F,2E,e0,0E, 3F, 2E 

2400 data 00, 00, 2F, 2E, 00, OA, 3F, 3C, 00, 4 
2, 4E, BA, 81,8A, DE, FC 

2410 data 00, OA, 2D, 40, FF, FC, OC, 80, 00, 0 
0,00, 00, 6D, 08, 20, 2E 

2420 data FF, FC, 60, 08, 80, D2, 3F, 3C, 00, 0 
1,3F, 2E, 00, 00, 42, A7 

2430 data 3F, 3C, 00, 42, 4E, BA, Ol, 60, DE, F 
C,08,0A,2D,48,FF,F0 

2440 data 3F, 3C, 00, 02, 3F, 2E, 00, 00, 42, A 
7,3F, 3C, 00, 42,4E,BA 

2450 data 01, 46, DE, FC, 00, OA, 2D, 40, FF, F 

4, 0C,6E, 00, 01, 00, OE 

2460 data 66, OE, 20, 2E, FF, F8, DO, AE, 00, 0 
A, 2D, 40, 00, OA, 60,24 

2470 data OC, 6E, 00, 02, OO, OE, 66, OE, 20, 2 
E, FF,F4, DO, AE,00, OA 

2480 data 2D, 40, 00, OA, 60, OE, 30, 2E, 00, 0 
E, 67, 08,20, 3C, FF, FF 

2490 data FF, FF, 60, 62, 20, 2E, 00, OA, BO, A 

E, FF,F4, 6F, IE, 48,6E 

2500 data FF, F2, 20, 2E, 00, OA, 90, AE, FF, F 
4,2F,00,3F,2E,00, 08 

2510 data 3F, 3C, 00, 40, 4E, BA, 00, EO, DE, F 
C, 00,0C, 42, 67, 3F, 2E 

2520 data 00, 00, 2F, 2E, 00, OA, 3F, 3C, 00, 4 
2, 4E, BA, 00,CA,DE,FC 

2530 data 00, OA, OC, 00, 00, 00, 00, 00, 5D, C 
0, CO, 7C, 00, 01,39, 40 

2540 data EO, 70, 67, OA, 20, 3C, FF, FF, FF, F 

F, 60,OA, 60, 00, 42, 6C 

2550 data E8, 78, 20, 2E, 00, OA, 4E, 5E, 4E, 7 

5, 4E, 56, 00, 00, 2F,2E 

2560 data 00, 08, 3F, 3C, 00, 49, 4E, BA, 00, 0 
E,5C,8F, 4E, 5E,4E,75 

2570 data 4E, 56, FF, FE, 42, 6E, FF, FE, 60, 2 

6, 30, 2E, FF, FE,E5,80 

2580 data 41, EC, E7, 40, DO, CO, 30, 10, BO, 6 
E, 00, 08, 66, OE, 30, 2E 

2590 data FF, FE, ES, 80, 41, EC, E7, 40, DO, C 
0,42,50, 52, 6E, FF, FE 

2600 data OC, 6E, 00, 4C, FF, FE, 6D, D2, 4E, 5 
E,4E, 75, 4E, 56, FF,FE 

2610 data 3F, 07, 3E, 2E, OO, 08, 3D, 7C, 01, 3 
0,FF,FE, 41, EC,E7,40 

2620 data 22, 40, D2, EE, FF, FE, BE, 50, 67, 0 
6,58, 48, B3, C8,66,F6 

2630 data 30, 28, 00, 02, 3E, IF, 4E, 5E, 4E, 7 
5, 29, 49, E7, 44, 29, 4A 
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2648 data E7, 48, 29, 5F, E7, 3C, 4E, 4D, 22, 6 
C,E7,44,24,6C,E7,4e 

2658 data 2F, 2C, E7, 3C, 4E, 75, 29, 49, E7, 4 
4,29,4A,E7,4e,29,5F 

2668 data E7, 3C, 4E. 41, 22, 6C, E7, 44, 24, 6 

C, E7,48, 2F, 2C,E7, 3C 

2678 data 4E, 75, 4E, 56, 88, 88, 68, 34, 28, 6 
E, 88, 88, 18, 18, 48, 80 

2688 data B8, 7C, 88, 8A, 66, 8E, 3F, 3C, 88, 8 

D, 3F,3C,88, 82,4E,BA 

2698 data FF, C6, 58, 8F, 28, 6E, 88, 88, 52, A 

E, 88,88, 18, 18,48,88 

2788 data 3F, 88, 3F, 3C, 88, 82, 4E, BA, FF, A 
E,58,8F,38,2E,88,8C 

2718 data 53, 6E, 88, 8C, 4A, 48, 66, C8, 4E, 5 

E, 4E,7S,4E, 56,88,88 

2728 data 68, 18, 28, 6E, 88, 88, 52, AE, 88, 8 
8,18, 18, 48, 88, 3F, 88 

2738 data 3F, 3C, 88, 84, 4E, BA, FF, 88, 58, 8 

F, 38, 2E, 88, 8C,53, 6E 

2748 data 88, 8C, 4A, 48, 66, DC, 4E, 5E, 4E, 7 
5, 4E, 56, 88, 88, 68, 18 

2758 data 28, 6E, 88, 88, 52, AE, 88, 88, 18, 1 
8,48,88, 3F,88,3F,3C 

2768 data 88, 85, 4E, BA, FF, 52, 58, 8F, 38, 2 
E, 88, 8C, 53,6E, 88, 8C 

2778 data 4A, 48, 66, DC, 4E, 5E, 4E, 75, 4E, 5 
6,FF,F2,48,E7,88, 38 

2788 data 26, 6E, 88, 8A, 24, 48, 41, EC, 88, 2 
8, 2D,48, FF, F6, 8C, 6E 

2798 data 83, 88, 88, 88, 66, 16, 3F, 2E, 88, 8 
E,2F,6B, 4E, BA, FF,34 

2888 data 5C, 8F, 3D, 6E, 88, 8E, FF, FE, 68, 8 
8, 81,4C, 8C, 6E, 82, FF 

2818 data 88, 88, 66, 16, 3F, 2E, 88, 8E, 2F, 8 
B,4E,BA,FF,68,5C,8F 

2828 data 3D, 6E, 88, 8E, FF, FE, 68, 88, 81, 2 

E, 8C,6E,82,FE,88,88 

2838 data 66, 16, 3F, 2E, 88, 8E, 2F, 88, 4E, B 

A, FF,78,5C,8F,3D,6E 

2848 data 88, 8E, FF, FE, 68, 88, 81, 18, 2D, 4 

B, FF,FA,42,6E,FF,FE 

2858 data 3F, 2E, 88, 88, 4E, BA, FE, 76, 54, 8 

F, 4A, 48, 66, 88, 88, A6 

2868 data 68,88,88,94,18,12,48,88,88,7 

C, 88, 8A, 66, 88, 88, 86 

2878 data 28, 8A, 98, AE, FF, FA, 88, 7C, 88, 8 
8, 6F, 4e,28,8A,98, AE 

2888 data FF, FA, 48, C8, 2D, 48, FF, F2, 2F, 2 
E,FF,FA, 2F,2E, FF,F2 

2898 data 3F, 2E, 88, 88, 3F, 3C, 88, 48, 4E, B 
A, FE, 7C,DE, FC, 88, 8C 

2988 data 39, 48, E8, 78, 48, C8, B8, AE, FF, F 
2,67, 88, 38, 3C, FF, FF 

2918 data 68, 88, 88, A8, 38, 2C, E8, 78, Dl, 6 
E,FF,FE,2F,2E,FF,F6 

2928 data 2F, 3C, 88, 88, 88, 82, 3F, 2E, 88, 8 
8, 3F, 3C, 88, 48, 4E, BA 

2938 data FE, 46, DE, FC, 88, 8C, 39, 48, E8, 7 
8,8C, 48,88,82,67,86 

2948 data 38, 3C, FF, FF, 68, 74, 52, 6E, FF, F 
E, 52, 8A,2e,8A, 20,48 

2958 data FF, FA, 68, 82, 52, 8A, 28, 8A, 98, 8 
8,88, 6E, 88, 8E, 65, 88 

2968 data FF, 64, 68, 18, 28, 8B, 36, 2E, 88, 8 
E, C6, BC, 88, 88, FF, FF 

2978 data D8, 83, 24, 48, 28, 8A, 98, AE, FF, F 
A,48, C8,2D, 48, FF, F2 

2988 data 2F, 2E, FF, FA, 2F, 2E, FF, F2, 3F, 2 
E, 88, 88, 3F, 3C,88, 48 

2998 data 4E, BA, FD, E4, DE, FC, 88, 8C, 39, 4 
8, E8,78, 48, C8,B8, AE 

3888 data FF, F2, 67, 86, 38, 3C, FF, FF, 68, 1 
8,38,2C,E8, 78, D1,6E 

3818 data FF, FE, 42, 6C, E8, 78, 38, 2E, FF, F 
E,4C, DF, 6C, 88, 4E, 5E 

3828 data 4E, 75, 43, EC, EF, 84, 12, FC, 88, 5 
8,12, FC, 88,32, 12, FC 



3838 data 88, 5D, 12, FC, 88, SB, 12, FC, 88, 2 
8, 12, FC, 88, 42, 12, FC 

3848 data 88, 75, 12, FC, 88, 73, 12, FC, 88, 7 
9, 12, FC, 88, 28, 12, FC 

3858 data 88, 42, 12, FC, 88, 75, 12, FC, 88, 6 
4, 12, FC, 88, 64, 12, FC 

3868 data 88, 79, 12, FC, 88, 28, 12, FC, 88, 6 
2, 12, FC, 88, 79, 12, FC 

3878 data 88, 28, 12, FC, 88, 4D, 12, FC, 88, 6 
1, 12, FC, 88, 74, 12, FC 

3888 data 88, 2A, 12, FC, 88, 52, 12, FC, 88, 6 
1,12,FC,88,74, 12, FC 

3898 data 88, 7C, 12, FC, 88, 28, 12, FC, 88, 7 
C, 12, FC,88, 28, 12, FC 

3188 data 88, 42, 12, FC, 88, 61, 12, FC, 88, 6 
3, 12, FC, 88,68, 12, FC 

3118 data 88, 73, 12, FC, 88, 78, 12, FC, 88, 6 
1, 12, FC, 88,63, 12, FC 

3128 data 88, 65, 12, FC, 88, 28, 12, FC, 88, 7 
3, 12, FC, 88,65, 12, FC 

3138 data 88, 6C, 12, FC, 88, 65, 12, FC, 88, 6 
3,12, FC, 88, 74,12,FC 

3148 data 88, 2C, 12, FC, 88, 28, 12, FC, 88, 4 
1,12, FC,88, 53,12,FC 

3158 data 88, 43, 12, FC, 88, 49, 12, FC, 88, 4 
9,12,FC,88, 3F,12,FC 

3168 data 88, 28, 12, FC, 88, 5D, 12, FC, 88, 5 

B, 12, FC, 88,28, 12, FC 

3178 data 88, 38, 12, FC, 88, 7C, 12, FC, 88, 2 
8, 12, FC, 88,31, 12, FC 

3188 data 88, 32, 12, FC, 88, 36, 12, FC, 88, 7 

C, 12, FC, 88,28, 12, FC 

3198 data 88, 31, 12, FC, 88, 32, 12, FC, 88, 3 
7, 12,FC, 88, 5D, 12, FC 

3288 data 88, 88, 43, EC, EF, 8C, 12, FC, 88, 5 
8,12, FC, 88, 31,12, FC 

3218 data 88, 5D, 12, FC, 88, SB, 12, FC, 88, 2 
8,12,FC,88, 7C,12,FC 

3228 data 88, 28, 12, FC, 88, 42, 12, FC, 88, 7 
5, 12, FC, 88,73, 12, FC 

3238 data 88, 79, 12, FC, 88, 28, 12, FC, 88, 4 
2, 12, FC, 88, 75, 12,FC 

3248 data 88, 64, 12, FC, 88, 64, 12, FC, 88, 7 
9, 12, FC, 88, 28, 12, FC 

3258 data 88, 69, 12, FC, 88, 73, 12, FC, 88, 2 
8, 12, FC, 88, 6E, 12, FC 

3268 data 88, 6F, 12, FC, 88, 77, 12, FC, 88, 2 
8,12,FC,88,4F,12,FC 

3278 data 88, 46, 12, FC, 88, 46, 12, FC, 88, 2 
8,12,FC,88,7C,12,FC 

3288 data 88, 28, 12, FC, 88, SD, 12, FC, 88, 5 
B,12,FC,88,28,12,FC 

3298 data 88, 4F, 12, FC, 88, 48, 12, FC, 88, 2 
8,12, FC, 88, SD, 12, FC 

3388 data 88, 88, 43, EC, EF, 48, 12, FC, 88, 5 

B, 12, FC, 88, 32, 12, FC 

3318 data 88, SD, 12, FC, 88, SB, 12, FC, 88, 2 
8,12,FC, 88, 42, 12, FC 

3328 data 88, 75, 12, FC, 88, 73, 12, FC, 88, 7 
9,12,FC,8e,28,12,FC 

3338 data 88, 42, 12, FC, 88, 75, 12, FC, 88, 6 
4,12,FC,88,64,12,FC 

3348 data 88, 79, 12, FC, 88, 28, 12, FC, 88, 4 

D, 12, FC, 88, 61, 12, FC 

3358 data 88, 78, 12, FC, 88, 69, 12, FC, 88, 6 
D,12, FC,e8,75, 12, FC 

3368 data 88, 6D, 12, FC, 88, 28, 12, FC, 88, 7 

C, 12, FC, 88,28, 12, FC 

3378 data 88, 54, 12, FC, 88, 69, 12, FC, 88, 6 

D, 12, FC, 88, 65, 12, FC 

3388 data 88, 28, 12, FC, 68, 4C, 12, FC, 88, 6 
9,12, FC, 88, 6D, 12, FC 

3398 data 88, 69, 12, FC, 88, 74, 12, FC, 88, 3 
F,12, FC, 88, 28, 12, FC 

3488 data 88, 7C, 12, FC, 88, 28, 12, FC, 88, 7 
C,12,FC,88,2e,12,FC 

3418 data 88, 4D, 12, FC, 88, 69, 12, FC, 88, 6 

E, 12,FC,88,75,12,FC 
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3428 data 88, 74, 12, FC, 88, 65, 12, FC, 88, 7 
3, 12,FC,8e,2B, 12, FC 

3438 data 88, 5D, 12, FC, 88, 5B, 12, FC, 88, 2 
8, 12, FC,88,28, 12, FC „ , 

3448 data 88, 35, 12, FC, 88, 28, 12, FC, 88, 7 
C, 12, FC,88, 28, 12, FC 

3458 data 88, 31, 12, FC, 88, 35, 12, FC, 88, 2 
8, 12, FC, 88,7C, 12, FC 

3466 data 88, 28, 12, FC, 88, 36, 12, FC, 88, 3 
8,12,FC,e8,28,12,FC „ „ 

3478 data 88, 5D, 12, FC, 88, 88, 43, EC, EF, 8 
E,12,FC,88,5B, 12,FC 

3488 data 88, 32, 12, FC, 88, 5D, 12, FC, 88, 5 

B, 12,FC,e8, 28,12,FC 

3490 data 88, 42, 12, FC, 88, 75, 12, FC, 88, 7 
3,12,FC,88, 79,12,FC 

3588 data 88, 28, 12, FC, 88, 42, 12, FC, 88, 7 
5, 12, FC,88, 64, 12, FC 

3510 data 88, 64, 12, FC, 88, 79, 12, FC, 88, 2 
8, 12, FC,88,54, 12, FC 

3528 data 88, 49, 12, FC, 88, 4D, 12, FC, 88, 4 
5, 12, FC, 88, 4F, 12, FC 

3538 data 88, 55, 12, FC, 88, 54, 12, FC, 88, 2 
6, 12,FC,88,7C,12,FC 

3548 data 88, 28, 12, FC, 88, 7C, 12, FC, 88, 2 
8,12,FC,e8, 53, 12, FC 

3550 data 88, 68, 12, FC, 88, 61, 12, FC, 88, 6 

C, 12, FC,e8, 6C, 12, FC 

3568 data 88, 28, 12, FC, 88, 49, 12, FC, 88, 2 
8,12, FC,88, 3F, 12, FC 

3570 data 88, 28, 12, FC, 88, 5D, 12, FC, 88, 5 

B, 12,FC,88,28, 12, FC 

3588 data 88, 45, 12, FC, 88, 78, 12, FC, 88, 6 
9, 12, FC,88, 74,12, FC 

3590 data 88, 28, 12, FC, 88, 7C, 12, FC, 88, 2 
8, 12, FC, 88, 52, 12, FC 

3680 data 88, 65, 12, FC, 88, 73, 12, FC, 88, 7 
4,12, FC, 88, 61, 12, FC 

3610 data 88, 72, 12, FC, 88, 74, 12, FC, 88, 2 
8,12, FC, 88, 5D, 12, FC 

3628 data 88, 88, 43, EC, E8, C6, 22, FC, 88, 8 

8, 80, 88, 32, FC, 88, 88 

3630 data 22, FC, 88, 88, 88, 88, 32, FC, 88, 8 

9, 32, FC,83, 88,22, FC 

3640 data 88, 88, 88, 88, 32, FC, 88, 88, 22, F 

C, 80, 88,88, 88, 32, FC 

3650 data 88, 88, 22, FC, 88, 88, 88, 88, 32, F 
C, 81, 82,32, FC, 83,88 

3660 data 22, FC, 88, 88, 88, 88, 32, FC, 82, 8 
8,22,FC,88, 88, 88,88 

3670 data 32, FC, 88, 88, 22, FC, 88, 80, 80, 8 
8,32,FC,81, 82, 32, FC 

3688 data 83, 88, 22, FC, 88, 88, 88, 88, 32, F 
C, 82, 88,D2, FC, 85, 78 

3690 data 39, 7C, 82, 88, E8, C4, 4E, 75, 28, 2 
8,42,75,73,79,28,42 

3780 data 75, 64, 64, 79, 88, 88, 43, 4F, 4E, 3 
A, 80, 88,41, 55, 58, 3A 

3710 data 88, 88, 50, 52, 54, 3A, 88, 88, 8D, 8 
A, 88, 88,88, 88, 88, 82 
3720 data 86,88 
3730 data « 

Listing 2: 
C 

/ KKKKKKKKKKKKKKMMMlCKmilCKICIlKKlCMK / 

/* Busy Buddy accessory */ 

/* Copyright 1988 by 8T-Log «/ 

/» RatMUare by 

/* Matthew J. N. Ratcliff 

/* AKA MatwRat, All Rights */ 

/« Reserved. »/ 



Listing 1: 
Checicsums 

188 data 892, 948, 117, 614, 583, 22 

2, 418, 427, 14, 189, 4256 

198 data 654, 357, 649, 562, 84, 997 
, 774, 871, 9, 148, 5185 

1888 data 85, 766, 147, 934, 55, 216 
, 376, 255, 374, 375, 3583 

1188 data 397, 274, 876, 178, 887, 3 

7, 75, 62, 831, 29, 3638 

1288 data 59, 82, 819, 780, 685, 788 
, 741, 569, 15, 934, 5392 
1388 data 889, 937, 998, 854, 851, 9 

11, 838, 812, 68, 889, 8839 

1488 data 989, 980, 51, 991, 915, 74 
, 52, 125, 641, 828, 5566 

1588 data 741, 687, 787, 788, 857, 9 
86, 492, 481, 511, 485, 6647 

1688 data 494, 494, 587, 493, 495, 4 
77, 478, 522, 584, 485, 4949 

1788 data 484, 485, 488, 588, 495, 4 
98, 492, 773, 936, 152, 5295 

1888 data 248, 224, 149, 288, 388, 2 
82, 236, 73, 253, 948, 3881 

1988 data 182, 967, 113, 88, 947, 11 
6, 98, 8, 48, 68, 2539 

2880 data 945, 998, 945, 934, 864, 7 
48, 25, 762, 887, 61, 7161 

2188 data 858, 29, 184, 798, 983, 74 
1, 958, 988, 792, 746, 6997 

2288 data 984, 816, 981, 863, 879, 1 
16, 812, 752, 885, 794, 7642 

2388 data 938, 181, 932, 818, 928, 4 
9, 847, 958, 945, 948, 7432 

2488 data 869, 147, 27, 991, 969, 75 

3, 114, 862, 921, 267, 5928 

2588 data 974, 388, 194, 16, 286, 85 

8, 34, 988, 34, 727, 4331 

2688 data 881, 982, 956, 857, 738, 9 
39, 854, 771, 896, 64, 7858 
2788 data 957, 883, 45, 936, 978, 1, 
156, 955, 751, 47, 5781 
2888 data 366, 41, 217, 184, 783, 96 

9, 92, 965, 18, 162, 3797 

2988 data 64, 266, 112, 196, 72, 988 
, 987, 986, 989, 986, 5246 

3888 data 989, 918, 918, 986, 898, 9 
29, 886, 913, 986, 988, 9875 

3188 data 988, 981, 1, 938, 895, 982 
, 987, 924, 937, 912, 8217 

3288 data 911, 937, 982, 915, 914, 9 
13, 917, 951, 922, 948, 9382 

3388 data 936, 924, 921, 954, 989, 9 

12, 899, 984, 871, 17, 8247 

3488 data 922, 932, 988, 918, 938, 9 
28, 986, 956, 982, 919, 9285 

3588 data 938, 918, 926, 925, 897, 8 
92, 764, 795, 765, 866, 8678 

3688 data 882, 861, 768, 595, 566, 'l 
15, 3887 
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extern int gl_apid; 



/* Include files */ 

/ KKXMKKXKKKKKKICICMIC / 

ttinclude <stdio.h> 
itinclude <osbind.h> 

/» Global variables */ 

/ } i ii i iyiK-iiiiT i iyiif.T i iv.nn)nniimnyin / 

char Back_Type[]= 

"t2][ Busy Buddy by NatwRati | Backspace select, ASCII? ][ 8| 126| 1271"; 

char Buzzoff[]= 
"CllC I Busy Buddy is now OFF | ][ OK 

char Busy-Tine [] = 

"[2][ Busy Buddy Naxinun | Tine Linit? | | Minutes ][ 5 | 15 | 60 ]"; 
char Busy-Tout [] = 

"[2] I Busy Buddy TIMEOUT | | Shall I ? ][ Exit | Restart 

char Buddy-Byte, Backup; 
int Tine-Linit; 

/ XXXMKKXXKXMMK / 

/* Constants »/ 

/ XKXMKXMKXKKXX / 

ltdef ine 
ttdef ine 
ltdef ine 
lidef ine 
ttdef ine 
ttdef ine 
ttdef ine 
9def ine 
ttdef ine 
ttdef ine 
ltdef ine 
ttdef ine 
ttdef i ne 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 



EUNT-MSG 


0x0010 


EUNT-TIM 


0x0020 


TIME-H 


(intJO 


TIME-L 


(int) 2000 


AC-OPEN 


40 /» 


ASCI 1-8 


1 


ASCII-126 


2 


ASCI 1-127 


3 


BS 


8 /» 


XE_DEL 


126 /* 


ST-DEL 


127 /» 


SPACE 


32 /» 


PRT 


0 /* 


AUX 


1 


CON 


2 


MIDI 


3 


KBD 


4 


FIUE-MIN 


(int) 150 


FIFTEEN-MIN 


(int)450 


SIXTV-MIN 


(int) 1800 


SEL-FIUE 


1 


SEL-FIFTEEN 


2 


SEL-SIXTV 


3 


BELL 


7 



/» Startup accessory end*/ 



*/ 
*/ 
*/ 
*/ 



/ KXKKKKKMMMKXItKKKKKKKKXKKKXKKKKXKKXKXXKKKKKKKXKXXKKKXKMKM / 



/* Progran: Busy Buddy */ 

/* Type: Desk accessory */ 

/* Purpose: Busy Buddy, when activated, initiates */ 
/« a 2 second tined interval for sending alternating */ 

/* space and backspace characters over the noden. */ 

/* This feature will keep the systen at the other */ 

/* end BUSV. This will prevent nost BBS and «/ 

/* teleconnunication systens fron TIMING OUT «/ 

/* on you, so you have tine for a Budweiser break. «/ 



/ XKKKKKXXXKMKKXKKKKWKXXKXKMXXKKXXKKKKXXKKKXXKKXKKKXXKKKKK ^ 

nainO 

( /» Get busy BUDDY! */ 
int nenu-id; 
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int ngin[8] ; 

int dun, event, flag; 

int forever; 

/ KKKKMMICMKMKICMmiKlCKKmCK / 

/* Install accessory: «/ 

/ ICICMItlllCKKKKKKKICMKltmtKIlK / 

appl-initO ; 

nenu_id - nenu_resister Cgl_apid, " Busy Buddy"); 

/' KXKKMKMKKICKKKmtmimCKKICKKMKllKICKKItmCMKKlCICKICItMKKKICKKlCKMKIC /' 

/* Event nessage only, until activated the first tine */ 

flag = EUNT_MSG; 
forever - 1; 

while (forever) 

C /* loop forever */ 

dun =8; 

event - evnt_nultiC flag, -1, -1, -1, 

dun, dun, dun, dun, dun, /* de-daaa «/ 
dun, dun, dun, dun, dun, /* de-dooo */ 
ngin, TIME-L, TIME.H, 
&dun, Sdun, &dun, &dun, &dun, &dun] ; 
if (event & EUNT_MSG) 

if (ngin [81 -- AC-OPEN && ngin (41 == nenu_id] 
if (flag & EUNT-TIN) 
t 

flag = EUNT-MSG; 
Buddy_Of f () ; 
event - 8; 
> 

else 
€ 

flag = EUNT-TIM | EUNT.MSG; 
Buddy-OnO ; 
event = 8; 
> 

if (event & EUNT.TIM) 
if (flag & EUNT_T1M) 
C 

Buddy () ; 

if (Tine-Linit <= 8) 
flag = Buddy_Toff (); 

> 



} /* end loop forever */ 
} /* end nainO «/ 

/ MKXMMMmCKKmCMKMMKKKKKMKKlCKKKKlCMKXKKKKKKKKKKXKICKKMKlCKKKKXKKMMK /' 

/w Function: Buddy-OnO */ 

/* Description: Initialize Busy Buddy. Allow user to select */ 

/* backspace or delete type of backup. Initialize Backup */ 

/* variable and send first SPACE character to begin process. */ 

/ KXXXXXXMKMKKKKKXKKXKKKMXKKKXKKXXXKKXKKXXXXKXXXKXXXXXXXXXXKXXX /' 

Buddy_On() 

{ /* begin Buddy_On() »/ 
int bsel; 

bsel = f orn_alert(l, Back-Type) ; /» Get backspace or delete type «/ 

switch (bsel) 

{ /* begin switch */ 
case (ASCII-B): 
Backup = BS; 
break; 

case (ASCII_126]! 
Backup = XE-DEL; 
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break; 

case (ASCII_127): 
Backup = ST_DEL; 
break; 



default: 
break; 

} /* end switch »/ 

Get_Linit() ; 
Send-ByteC SPACE ); 
Buddy-Byte = Backup; 

} /* end Buddy-OnO */ 



/* Set tine Unit »/ 
/» Start the busy signal */ 
/» setup for backspace next tine*/ 



/ ItKKMMKKmiKKMMKKKKKXItKMKKMimMICKMMMHKKKKKKKKKMMIllClCKKKKMKKKKKKMM / 

/* Function: Buddy_Off (1 

/» Description: Make certain that a backup character was the »/ 
/» last thing sent Cspaces nust be natched with backups), */ 
/* then inforn the user that Busy Buddy is dornant. «/ 

/ MKKKXMKMKKMKMKKKKMMXMKIIMKKKKllllKKKKMXICKlCKKKKKKKKKKMKMKKXMKMKKK / 

Buddy-Off C) 

C /* begin Buddy_Off () «/ 

if (Buddy-Byte == Backupl /* Make certain that backup was */ 

Send_Bytet Buddy_Byte ); /» last character sent */ 

f orn-alertd, Buzzoff J; /» Tell user busy is off now »/ 

} /* end Buddy-Off () */ 



/ XKKKXXXXKKXXKXKXXXXXKKXXXXKKXXKKXXXXXXXKKKXXKXXXKKKXXKXXKXXXX / 

/* Function: Buddy () 

/» Description: Send the current character fron Buddy_Byte. »/ 
/* Then toggle fron SPACE to BACKUP, or BACKUP to SPACE for */ 
/* next 2 second interrupt. 

/ XKXXKKXXKXKKMKXXXXKXKXKXKKXXKKXXXKKKKXXXXXKKKKKXXXKKXXKKKKKKK / 

Buddy () 

C /« begin Buddy C) */ 
Send-ByteC Buddy-Byte ); 



if (Buddy-Byte == SPACE] 

Buddy-Byte = Backup; 
else 

Buddy-Byte = SPACE; 
Tine-Linit — ; 
} /* end Buddy () */ 



/* Send current space or backup */ 

/* If space just sent, backup »/ 
/* next tine. »/ 

/* If backup just sent, then */ 
/* send space next tine. */ 



/ XXXXKXXXKXXKKKXXXKXKXKKXXXXXKXXXXXXXXXXXXXXXXXXXXXXXXXXXKXXXX / 

/* Function: Send-By te( char 1 

/* Description: Send the character received to the AUX, RS232»/ 
/« port, using the Bconout function. 

/ KXXKXXKXXXKXXXXKXXXKXXXXXXXXXXKKXXKXKXXXXXXXXXKKXXXXXXXKKXXKK / 

Send-ByteC dude ) 
char dude; 

C /* begin Send-ByteC char ) */ 

/ XKXXXKXXXKXXXXXKXXXXXXKXXXXXXXXXXXXXXKKKKKXKXXXXXXX / 

/» Send the caracter passed to the AUX, RS232 Port */ 
Bconout C AUX, dude } ; 
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} /* end Send_Byte( char 1 */ 



/* Function: Buddy_Toff () returns ( INT 1 */ 

/* Description: Hake certain that a backup character was the */ 

/* last thing sent (spaces nust be natched with backups), */ 

/* then inforn the user that Busy Buddy is tined out. */ 

/* Return flag status for next event nulti. »/ 



/ XXXXXKXMKKMXKXKKKKKXKKKXKKKXKKXKXKKKKKXKKXMKXXKXXKXKXXKXXKXXK / 

Buddy_Toff () 

C /» begin Buddy_Toff () */ 

ttdefine BEXIT 1 
ttdefine BRESTART 2 

int sel, bflag; 

if (Buddy-Byte == Backup} /* Make certain that backup was */ 

Send_Byte( Buddy_Byte ); /* last character sent «/ 

Bconout( CON, BELL); /* MAKE UP CALL! «/ 

sel = f orn-alertd, Busy_Tout ); /* Tell user busy tined out »/ 

if (sel == BEXIT) 
{ 

bflag = EUNT_MSG; 

f orn-alertd, Buzzoff); 

> 

else 
C 

bflag = EUNT-MSG | EUNT-TIN; 
Get_Linit() J 

return ( bflag ); 



} /* end Buddy-Toff () */ 



/* Function: Get-LinitO »/ 
/* Description: Get naxinun tine linit for Busy Buddy to run »/ 
/* unattended. «/ 

/ XKXKXKXKXKKKKMKKXKKXXKXKKXKXXXKXXXXXXKKKKKKMXXXXKKXKXXXXXKXXX /' 

Get-LinitO 

C /» begin Get-Linit »/ 
int bself 

bsel = forn-alert (3, Busy-Tine ); 

switch ( bsel ) 

€ /« begin switch */ 
case (SEL-FIUE) : 

Tine-Linit = FIUE_MIN; 

break; 

case (SEL-FIFTEEN) : 

Tine-Linit = FIFTEEN-NIN; 
break; 

case (SEL-SIXTV) : 

Tine-Linit = SIXTV_MIN; 
break; 

default: 
break; 
} /» end switch »/ 

y /* end Get-Linit »/ 
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(continued from page 1 7) 
best features of the MAC, ported over 
to the ST. How about a desktop that al- 
lows you to place a favorite or often 
used program as a permanent part of 
the desktop? No, not a directory entry 
on a disk, but part of the desktop itself. 
Just like your disk drive and trash 
icons. Speaking of icons, they do of 
course support editable icons and 
about 40 other new features. Called 
NeoDesk, this package retails for 
$29.95 . . . and is available now. 

Atari dealers are really feeling the 
pinch as Atari heads into the summer. 
8-bit sales, oth.^r than the XEGS sys- 
tem, have slowed to a crawl for most 
retailers. Mail order seems to be getting 
by, but if you haven't been to your 
favorite 8-bit dealer lately, don't be sur- 
pirsed if the next time you go he is 
devoting more and more space to other 
products. Can it be that Atari 8-bit own- 
ers have all the software they want? If 
they went into stores carrying Atari 
8-blt products more often, they would 
learn about great new products like 
The Newsroom— a good desktop 
publishing package for the 8-bit. 

There are at least two companies de- 
veloping 16 MHz boards for the ST. The 
ST 68000 CPU normally operates at 8 
MHz, and it is this speed which limits 
how fast the ST can run a program. 
These new boards will replace the 
present 68000 with double speed units 
that will make your ST work at least 
150 percent faster than the present 
unit. Cost? About $200, not including 
installation. But be careful, the instal- 
lation could be a major cost. The 68000 
comes soldered onto the ST board and 
has to be desoldered and then resol- 
dered on the new board. This is no job 
for a friend using a woodbuming set as 
a soldering iron. 

Another company has already deve- 
loped a card cage for the Megas, but un- 
fortunately, they are only planning on 
offering it as part of their vertical mar- 
ket package (their own specialty soft- 
ware package). Too bad, since it has the 
ability to take most standard PC and AT 
cards. Nifty stuff like hard disk, modem 
and Fax cards. You know, all that good 
stuff you see advertised in PC mags for 
the guys that paid big bucks for their 
systems? 

If you haven't connected your ST to 
a stereo yet, do W. The sounds will floor 




you. Try it with something like Block- 
buster if you want to see how a good 
sound system can turn a nice game 
into something really super. 

Talk to Lou Swilling from Astra Sys- 
tems. Seems he's on a switch lately. By 
the time you read this ("famous last 
words"), Astra should be offering the 
following switch boxes: printer switch, 
DMA switch, floppy drive switch, 
RS232 switch (with two RS232 outputs 
and built-in null modem). Their won- 
derful monitor switch has been out for 
several months. Having trouble mak- 
ing up your mind, Lou? 

You might want to watch for a new 
advertising campaign sponsored by As- 
tra and Hybrid Arts. The Ads will fea- 
ture the Pointer Sisters standing in 
front of their 1040s and thousands of 
dollars worth of Hybrid Arts software 
and hardware. Clearly seen in the ad 
is the new rack mounted Astra 240 
Meg hard disk. 

Missing, but not forgotten dept. 



Missing: one multi-tasking, multi- 
user operating system called IDRIS. 
This is the Unix work-a-like system 
that Atari was hyping before Christ- 
mas. Anyone heard anything about it 
lately? When asked about it a week ago. 
Atari said it was available, but not be- 
ing marketed by Atari. Something 
about failing to reach an agreement on 
price. The product is finished and is 
marketed by the company that origi- 
nally wrote it. In the meantime. Atari 
has been advertising for a full software 
team to adapt a version of Unix 3.2 for 
them. (An OS for the 68030 product?). 

Did 1 say 68030? Sure the one that 
was shown in the back room at the 
Hanover Trade Fair this past spring 
(the CBit computer show in West Ger- 
many). You know, the one that will 
plug into the Mega and use it as a front 
end? You already own a keyboard at- 
tached to a box with a bunch of ports 
in it, right? Why buy another keyboard 
or more ports just to quadruple the 
power of your system? Just buy this 
box with a 68030, its memory and oper- 
ating system and plug it into your 
mega via the expansion port. No, an up- 
graded 520 or 1040 does not equal a 
mega in this case. 

Congratulations! Atari is now listed 
in the Fortune 500. Yes, the guys from 
Sunnyvale are number 486 with a 
bullet. P.S. Commodore was nowhere 
on the list. 

Finally — Rupert Murdock (of big me- 
dia fame) recently ordered 7000 PC 
clones to be delivered within 30 days. 
Orders like this just don't happen in 
the ST world. But wouldn't it be 
nice. . . 



TG can often be found skulking the turf 
around Hollywood and Vine where many 
a celebrity has been discovered. He is 
seen frequenting bars in the area, carry- 
ing what he calls the only true portable 
computer: an ST plugged into a heavy- 
duty truck battery. He writes this column 
to make a living until he breaks into film, 
and to provide the cash he needs to 
recharge his truck battery every month. 
Hear anything good? Write it down and 
stick it with used gum on the underside 
of the pay-phone at the address above. 
(Don't live in LA-LA land? Send TG mail 
to: ST-Log, 91 71 Wilshire Bid,, Suite 300, 
Beverly Hills, OA 90210) 
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BOOT UP 
TO BIG SAYINGS! 




1 YEAR FOR ONLY $28 

SAVE $14 OFF THE COVER PRICE 

1 YEAR WITH DISK OHVI $105 



SAVE TIME AND MONEY 
SUBSCRIBE TO ANALOG 

SAVE $14 OFF THE 
COVER PRICE WITH 
THE CONVENIENCE 
OF HAVING ANALOG 
DELIVERED DIRECT- 
LY TO YOUR DOOR 
BEFORE IT EVEN HITS 
THE NEWSSTANDS. 
GET THE MOST OUT 
OF YOUR COMPUTER. 
SUBSCRIBE TO 
ANAIOG 
TODAY 



□ 1 YEAR @ $28 — SAVE $14! 
FOREIGN - ADD $7 PER YEAR 

□ 1 YEAR WITH DISK @ $105 
FOREIGN — ADD $15 PER YEAR 



DCGWY 



□ PAYMENT ENCLOSED 
CHARGE MY; □ VISA 



□ BILL ME 

□ MC # 



EXPIRATION DATE SIGNATURE 

MONEY BACK ON ALL UNUSED PORTIONS OF SUBSCRIPTIONS IF NOT SATISFIED. 



NAME 



ADDRESS 



CITY 



STATE 



ZIP 



MAKE CHECK PAYABLE TO L.F.P., INC.. P.O. Box 16927, N. Hollywood, CA 91615. Offer expires August 
31, 1988. Your first issue will arrive in 6 TO 8 weeks. 



WATCH FOR IT! 



Attention 
Programmers! 




ANALOG Computing is interested in programs, articles, and software review sub- 
missions dealing with the Atari home computers. If you feel that you can write as well 
as you can program, then submit those articles and reviews that have been floating 
around in your head, awaiting publication. This is your opportunity to share your knowl- 
edge with the growing family of Atari computer owners. 



All submissions for publication, both program listings and text, should be provided 
in printed and magnetic form. Typed or printed copy of text is mandatory and should 
be in upper and lower case with double spacing. By submitting articles to ANALOG 
Computing, authors acknowledge that such materials, upon acceptance for publica- 
tion, become the exclusive property of ANALOG Computing. If not accepted for pub- 
lication, the articles and/or programs will remain the property of the author If submissions 
are to be returned, please supply a self -addressed, stamped envelope. All submissions 
of any kind must be accompanied by the author's full address and telephone number 

For those of you who are sincerely interested in the rules and regulations for publica- 
tion, we've taken this opportunity to print our guidelines for authors. See page 128 of 
this book for everything you'll need to know. 




Send your programs and articles to: 
Editor, ANALOG Computing 

RQ Box 23, Worcester, MA 01603. 



TUTORIAL 



Read Any 

Good Docs, Lately? 



by David L. Coles 

Only seconds remain until the com- 
pletion of your sophisticated program. 
The debugging finished, you smile in 
the knowledge that shortly the mail 
will bring the announcement of your 
induction into the "Coders Hall of 
Fame." But as you stagger off to relax 
it hits you — you're not through yet! 

You've forgotten the little matter of 
documentation. No sweat, you reason; 
tomorrow you'll knock something out 
to guide the troops through the woods. 
Unfortunately, if you believe that will 
be sufficient, you're either too tired to 
think straight, or are grossly mistaken 
about the needs of computer users. 
Your software may well ensure your 
place in the Coders Hall of Fame, but 
do you really want all those angry 
users burning the documentation in 
protest during the induction 
ceremonies? 

hiadequate or confusing documenta- 
tion dooms many otherwise excellent 
programs to collect dust after only a 
few uses, while it prevents others from 
being used to their fullest potential. 
Rather than just "knocking something 
out," you have the responsibility to 
complement your software with good 
quality documentation. But don't con- 



fuse this with generating returns of 
paper. The task is to strike a balance 
between frustrating users with too lit- 
tle information and frightening them 
with too much. Ideally, you provide 
Just the right amount of instruction to 
get the program installed, fully explain 
its operation, and provide ready refer- 
ences when a quick refresher is 
needed. 

One very effective method of produc- 
ing such quality documentation is for 
you to actually work through the in- 
stallation and operation of the program 
yourself, noting each step as you go. 
These notes are then collated into an 
outline, and eventually become the 
backbone of your documentation. This 
article explains how to utilize this 
method, and presents some helpful tips 
to make your documentation more in- 
teresting. But the thought processes 
used for developing docimientation are 
different than those used for program- 
ming. So, before you grab your favorite 
crayon to begin writing, set the project 
aside for several days, allowing suffi- 
cient time to clear your mind. 

The logical way to start is to place 
yourself in exactly the same position 
that your users will be in when they 



first lay hands on your program. Only 
by treating yourself as a first-time user 
will you be able to spot some of the 
more obvious items ("Oh, did my 
documentation neglect to mention that 
you had to have BASIC on the working 
disk . . . sorry 'bout that!"). To do this 
you will need to start with a working 
distribution copy of your soft ware, one 
that will be identical to the one users 
will eventually have. This means it 
should contain only the programs you 
will be distributing, without any oper- 
ating system, interpreters, compilers, 
or other proprietary commands. 

Program installation is usually a one- 
time function, so it is best to treat it as 
a separate section in the documenta- 
tion. Installation might be simply a 
matter of getting the command(s) onto 
a "working" system disk; or it could in- 
volve implementing specific peripher- 
als, or special command and/or data file 
configurations. In any event, work 
through all the various installation 
functions, keeping a step-by-step log of 
exactly what you did (and in what ord- 
er you did it) until you have complet- 
ed installing your program. 

The operating instructions are the 
real heart of any documentation. As 
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the program author, you have invest- 
ed countless hours producing the pro- 
gram and are therefore familiar with 
every nuance of its operation. This sec- 
tion of the documentation has the task 
of successfully transferring all this 
operational expertise to the user. 

Your program may be completely 
menu-driven, with the ability to walk 
users through its operation: or it may 
require that the user be familiar with 
special "commands." Either way, work 
through all the various operating func- 
tions, keeping a step-by-step log simi- 
lar to the one you kept for the installa- 
tion function. Once this phase is com- 
pleted you will haved compiled a set of 
notes which detail every step necessary 
for installing and operating your 
program. 

Next, you'll need to formulate an out- 
line for your documentation. A 
representative, full-blown outline 
might include the following: 

• Cover Sheets 

— Title page 

— Copyright, disclaimers 8c 
warranty 

• Table of Contents 

• Introduction 

— Program features, results, etc. 

— Special notes (system configura- 
tion, etc.) 

• Getting Started 

— System familiarization 

— System start-up 

— Creating backup &: working disks 

• Installation 

— (Part of your notes will be used 
here.) 

• Operating Instructions 

— (The majority of your notes will 
be utilized here.) 

• Reference section 

• Index 

With your notes and suitable outhne, 
you're ready to begin writing the 
documentation. It may appear that the 
hardest part is yet to come. But remem- 
ber, the majority of your documenta- 
tion will come from the notes you have 
taken. What remains now is simply to 
transform these notes into an instruc- 
tional text format and place them in 
the appropriate section. 

To accomplish this, each function of 
installation and operation should be in- 
troduced with a function definition and 
an explanation of any associated op- 
tions. The definition is followed by a 
narrative explaining how to execute 



the function and an execution 
example. 

To illustrate, let's see how this might 
work for a fictitious program entitled 
"DOIT." Assume that the program is 
not menu-driven, but instead requires 
that all optional arguments be includ- 
ed in the "command tail." 

DOIT is a program which . . . (defini- 
tion would be presented here). 

DOIT allows you to select various op- 
tions. You may choose: 

• The drive containing the file you 
want DOIT to use. 

• The name of the file to DOIT to 

• The echo results to your printer 

• The number of times to DOIT 

• The individual record to start with 

• The field number to start with 

• The field number to stop with 

These options are selected at the time 
DOIT is executed from the command 
(or ready) state. 

To illustrate the operation of DOIT, let's 
assume: 

• Drive A contains the file you want 
DOIT to use 

• You want to DOIT to a file named 
FILENAME.EXT. 

• You want the results echoed to the 
printer 

• You want to DOIT three times 

• You want to start with record #1 

• You want to select field #3 through 
H 



Under these circumstances you would 
execute DOIT by entering: 

The commas (,) are important, so be 
sure to include them. If you choose not 
to use a particular option, you must 
still include the comma. To demon- 
strate this important use of punctua- 
tion, the following example illustrates 
the execution of DOIT, first echoing the 
results to the printer and then again 
without echoing the results (as a train- 
ing aid, an arrow ( ) has been placed un- 
der the "P" which selects this option): 



"P" selects echo option 

DOIT A:FILENAME.EXT,P,3,1,3,4 



Missing "P" eliminates echo option 
DOIT A:FILENAME.EXT„3,1,3,4 



Note in both examples that the total 
number of commas remains the same, 
only the "P" is affected! 

This example merely highlights the 
general nature of presenting operating 
instructions. In your documentation 
you would want to provide greater de- 
tail and cover additional items, such as 
defaults. 

Providing a reference section in your 
documentation can be a real time saver 
for the experienced user. Rather than 



DOIT A:FILEMME.EXT,P,5,1 ,3,4 



Stop field 
Start field 
Starting record 
Number of times to DOIT 
Echo results to printer 
Input file name 
Drive containing the input file 
Main command 
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having to wade through the operating 
instruction section again, they can sim- 
ply turn to the reference section for a 
quick memory job. Items you may 
want to consider for inclusion would 
be: 

• Abbreviated command summary 
listing with brief description of each 
command sequence or keystroke 

• Description of special flies needed or 
created by your program 

• List of error messages and remedies. 

• Glossary of unfamiliar words 

• User patches for such things as 
changing I/O ports, peripherals, etc. 

While not actually part of a reference 
section, an Index and Table of Contents 
are handy reference tools. Both are 
used to quickly direct the user to a 
specific location in the documentation, 
but they approach their task from op- 
posite directions. The Index is used to 
locate the desired page when the ap- 
propriate keyword is known. The Ta- 
ble of Contents is used when the gener- 
al function is known but the specific 
keyword is not known. 

Testing is the final, and most critical, 
part of documentation preparation. 
During the programming phase you 
tested all the program's permutations 
to spot the errors and omissions. This 
same type of testing needs to be per- 
formed on your documentation. 
However, this testing is better done by 
someone else. Give a friend a "distribu- 



tion diskette" and a copy of your 
documentation. Ask him to go through 
it just as if he had bought it off the 
shelf. Have your friend make notes of 
those areas that were confusing, need- 
ed more explanation, or were missing 
altogether. You might even consider 
doing this with several friends of differ- 
ing backgroimds and experience levels. 
Once your documentation has been 
thoroughly tested (a day or two for 
small- to medium-sized programs), 
review their comments and make the 
appropriate changes. 

Before ending this discussion, there 
are a few technical points to consider. 
The vocabulary you use affects overall 
understandability. Imagine how a new 
computer user would react to words 
such as argument, array, operand, 
string and I/O. Unfamiliar words force 
your reader to jump extra hurdles of 
intimidation to master the operation of 
your software. If you must use poten- 
tially unfamiliar words, thoroughly ex- 
plain them in plain English before 
thrusting them on your reader. Sen- 
tence structure is another factor which 
has a decided effect on readability. 
Keep sentences short and use commas 
sparingly. When tempted to include 
parenthetical statements using com- 
mas, ask yourself if readability would 
be increased by using two separate sen- 
tences instead. And finally, the man- 
ner In which explanations are present- 
ed affects how quickly they are under- 



stood. Consider the following two 
presentations of identical instructions. 
Which one seems easier to follow? 

THIS? 

Place the command disk in drive A 
and the data disk in drive B. Turn the 
computer on and allow it to initialize 
itself. When the computer signals it is 
ready, type the command: DOIT (and 
the return key). 

OR THIS? 

• Place the command disk in drive A 

• Place the data disk in drive B 

• Turn the computer on and allow it 
to initialize itself 

• When the computer signals it is 
ready, type the command; 

DOIT (and the return key). 

Presenting instructions in checklist 
format makes them easier to follow for 
someone who might be executing them 
"by-the-book." 

The type an(J quality of documenta- 
tion you provide with your program 
can greatly enhance its overall attrac- 
tiveness. Good quality documentation, 
like good quality programming, does 
not just happen. It requires thoughtful 
effort on your part. When approached 
in a step-by-step manner, producing 
quality documentation is not an insur- 
mountable task. In fact, it can actually 
be an exciting part of your overall soft- 
ware production efforts. (P.S. Enjoy the 
induction ceremony, you deserve it.) 
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Getting The Most From Your Flight Simulator II 

by Bob Curtin 



To those who've not experienced the 
Atari ST version of subLOGIC's Flight 
Simulator II, I can only extend my 
heartfelt condolences. I've had the op- 
portunity to use this program on a var- 
iety of machines, including an IBM PC- 
AT which, by the way, runs nearly as 
briskly as the ST version (Yes, I said 
nearly), but doesn't compare In the 
quality of graphics, features or ease of 
use. Regardless of the machine on 
which FS2 Is run, however, the pro- 
gram has a depth which becomes quite 
obvious if you do some research into 
the real thing, or better still, do some 
actual flying. Since I bought the pro- 
gram In 1984 for my Atari 800, FS2 has 
gotten literally hundreds of hours of 
machine time; more than anything 
else in my software library, with the ex- 
ception of programming and word 
processing software. 

In that time I've discovered a few 
things which might just make your 
own flying time a bit more enjoyable. 
FS2 is, after all, a simulation, and a very 
accurate one at that. You can spend 
countless hours just motoring about 
the skies, but if you're anything like 
me, you can only do so much sightsee- 



ing before the novelty wears off. Even- 
tually you'll want a challenge, some- 
thing to sharpen your flying and 
navigational skills. 

Fortunately, FS2 has enough to pro- 
vide you with challenges for years to 
come. The following paragraphs con- 
tain a few suggestions on how to go 
about taking advantage of the great 
depth of the simulation and above all, 
have some more fun with It. 

Need a Co-pilot? 

Before we get started, however, a 
word to those who are stark beginners 
or are just plain baffled by Flight Simu- 
lator 11. This article assumes you have 
at least some familiarity with FS2, but 
If not, you might be Interested in 
Charles Gullck's Flying Flight Simula- 
tor, published by Microsoft Press at a 
relatively inexpensive $9.95. The book 
is an excellent tutorial for beginners, 
as well as a handy reference for ex- 
perienced FS2 pilots. Mr. Gulick starts 
from the beginning and gradually leads 
the student pilot through ever more 
difficult lessons until, by the end of the 
book, the simulation Is covered in de- 
tail. Flying Flight Simulator Is a com- 
prehensive compendium of useful in- 



formation and it's a painless way to 
learn this complex program. 

The same author has written a cou- 
ple of books entitled 40 (and 40 More) 
Great Flight Simulator Adventures, 
published by Compute! Books. Yes, 
they're exactly what you think they 
are: a series of situations, complete 
with objectives, which you can set up 
on FS2 and play out. Now, on with the 
show. 

How about a section 8? 

The single greatest Improvement you 
can make In your simulation flying Is 
to give up navigating by the little maps 
which come with FS2 and the scenery 
disks and Invest In a set of standard 
aeronautical sectional charts. You can 
pick them up at just about any airport 
or order them through an aviation sup- 
ply house such as Sporty's Pilot Shop 
in Batavia, Ohio. A sectional chart is 
simply a map used by pilots to navigate 
both by visual flight rules and, in con- 
junction with other charts, instrument 
flight rules. There are 37 sectional 
charts covering the continental Unit- 
ed States (not counting Alaska), and the 
existing scenery disks supplied by sub- 
LOGIC conform so closely, you can 
navigate by them remarkably well. 
Navigating under VFR (Visual Flight 



If you kick 
the left 
rudder you 
can follow 
the pike 
south to 
Baltimore. 



Rules) becomes much easier with the 
sectional charts, especially when using 
the more detailed scenery disks. Major 
roads, rivers, lakes, mountains, cities, 
and even landmarks are accurately 
represented. (And I'll bet that all this 
time you thought those roads were ran- 
domly set there just for looks; to fill up 
empty space.) 



S2 
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For example, taking off from runway 
26 at Lancaster, PA, you cross over 
route 322, pick up route 30, fly over the 
Susquehanna river and run into route 
83. If you kick left rudder you can fol- 
low the pike south all the way to Balti- 
more. Each of these features is plainly 
visible on the Scenery Disk, but 
without intimate knowledge of the 
area, or without the use of a chart, you 
really can't tell what you're looking at. 
If you've been wondering just what it 
is you've been seeing down there, 
they're well worth the modest price. 

Although the FS2 Scenery Disks 
don't contain all of the airports in the 
real world, each sectional has around 
30 of them — all of the major airports 
and most of the secondary ones. When 
you're ready for that information, sec- 
tional charts will show you the transi- 
tion areas for instrument approaches, 
the airport control zones, and federal 
VOR airways. Scenery Disk #11, for ex- 
ample, contains four sectionals (all of 
which conform to standard NOAA sec- 
tional charts) and sports a grand total 
of 140 airports. Radio navigational aids 
are also in abundance, and almost all 
real-world beacons are represented 
with their corresponding frequencies. 
ATIS frequencies (Automatic Terminal 
Information Service) are present to a 
limited extent, as well as ILS (Instru- 
ment Landing System) at selected 
airports. 

Another thing the sectionals show 
you is prohibited airspace and restrict- 
ed areas. The airspace around military 
bases, for instance, and around major 
airports have certain requirements 
which must be met before private air- 
craft may enter. For some areas it's as 
simple as contacting Air Traffic Control 
before you enter, while for others, en- 
try is strictly prohibited. I grant you 
that the long arm of the FAA is not 
about to pop out of the screen in front 
of you and bend your floppy in two for 
violating prohibited airspace, but just 
for kicks, try doing some cross-country 
flying while observing the FAA altitude 
restrictions and avoiding restricted 
areas. You'll And it adds a whole new 
dimension to cross-country flying on 
FS2. No longer do you feel as if you're 
the only pilot in the sky, but part of an 
enormously intricate air trafflc control 
system and one who's expected to ob- 
serve the rules. 

And speaking of rules, I'll bet there 
aren't too many of you out there who 
ever enter into a standard traffic pat- 



tern when approaching an airport. Yes, 
I know, it's hard enough to get the 
beast onto the runway in one piece 
without having to worry about being 
neat about it. Guaranteed, however, 
that once you get the hang of it, it'll 
make landing much easier. Flying a 
traffic pattern correctly automatically 
lines you up with the runway at the 

I do 

recommend 
that you buy 
a good pilot^s 
training 
manual. 

right altitude for a nice, safe, unevent- 
ful landing. When you think you've got 
it down pat, try the same approach 
with a good, stiff crosswind. Then add 
some turbulence. Keep making things 
difficult for yourself until you hone 
your skill to a fine edge. 

What's a standard traffic pattern, you 
ask? Before you leave the pilots' supply 
house with that fist full of sectional 
charts, think about buying yourself a 
pilot's handbook. It'll tell you all you 
need to know about trafflc patterns. 

And I do recommend that you buy a 
good pilot's training manual; subLOG- 
IC provides a list of appropriate publi- 
cations in the front of their documen- 
tation that will definitely fit the bill. A 
good manual contains information on 
aerodynamics, meteorology, communi- 
cations, aeronautical charts, naviga- 
tion, airports, air traffic control, instru- 
ments, ILS, radio navigation, using a 
flight computer, and more. Also, invari- 
ably, there's a section containing the 
Federal Aviation Regulations. A lot of 
the material you'll find in these manu- 
als won't be applicable to the Flight 
Simulator II, but you'll be surprised at 
just how much is. 

Weather to Fly or Not? 

Chugging around the clear, still, 
friendly skies is one thing. Taking off, 
flying, and landing in stiff winds, limit- 
ed visibility and teeth-crunching turbu- 



lence is quite another. 

FS2 gives you full control over your 
environment, and what better way to 
add challenge to your flying than to 
conjure up some nice, hostile weather? 
High winds are great for creating havoc 
with your instrument flights, especial- 
ly long flights in which you're using ra- 
dio beacons to triangulate your posi- 
tion and set your course. 

For this kind of flying, you'll need to 
make another trip to your pilot's sup- 
ply house to pick up a flight computer; 
either electronic (wimpy) or an inex- 
pensive mechanical flight computer 
(which you should learn to use even if 
you do have an electronic computer). 
The mechanical computers are slip- 
sticklike affairs costing about five 
bucks for the cardboard and plastic 
kind. You'll need one of these com- 
puters for figuring true heading, (i.e. 
your actual heading taking into ac- 
count airspeed, wind speed and direc- 
tion, and compass heading), ground- 
speed, fuel consumption, and other 
useful information necessary to keep- 
ing your bearings in foul weather and 
avoiding becoming an unwilling and 
quite sudden part of the landscape. 
Again, the pilot's handbook which you 
dutiiully purchased will instruct you in 
the use of your new computer. And yes, 
it really does work. You can compute 
true heading, ETA, groundspeed and so 
forth, and apply the numbers to your 
simulation flying. Believe me, it's an 
education in itself. 

Crossing That Line. 

Now, what about when you want to 
fly from one sectional to another? Well, 
as long as both sectionals are on the 
same disk, there's no problem; you get 
no sensation of crossing a boundary. 
However, if the sectionals reside on 
different disks, there's a couple of 
minor problems. I must specify that 
although I've used FS2 on other 
machines, I've not had the opportuni- 
ty to test their reaction to scenery disk 
manipulation, so this section I can only 
guarantee to ST users. 

First, the original scenery, that is, the 
scenery which comes supplied on the 
FS2 disk itself, is not as accurate as the 
scenery disks which are sold separate- 
ly. I don't mean in terms of what they 
portray, but only in their scope. 

For instance, the New York section- 
al is missing almost 40,000 square 
miles on the west side; a giant rectan- 
gle from just west of New York City 
north to Tupper Lake, west to Prince 
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You^re likely 
to end up 
with the 
same 
problem 
which befalls 
a pilot flying 
from New 
York to 
Washington 
— a side trip 
to the 
Twilight 
Zone. 

Edward Bay in Lake Ontario, and tiien 
south again to a point just south of Har- 
risburg, Pennsylvania. Obviously, fly- 
ing west from the New York sectional 
to the Detroit sectional is impossible 
with any degree of realism. And all of 
the sectionals supplied with the FS2 
disk have similar problems. It seems 
that we'll just have to wait for the re- 
vised scenery disks for those areas to 
arrive. 

However, you can fly from the New 
York to the Washington sectionals (and 
Los Angeles to San Francisco) after 
spending about 40 miles or so in a 
featureless limbo. Just be sure you 
change the disks before the simulator 
goes looking for new data. 

Going from one scenery disk to 
another is no problem if you know ex- 
actly where you are. Each NOAA sec- 
tional chart has an overlapping area 
which matches up with adjoining 



charts. When you hit one of those areas 
on a sectional disk, change the disk to 
the one you're flying to. As soon as you 
leave the overlapping area, press "E" 
on your keyboard and the new scenery 
disk will take over. Of course, if you 
don't know exactly where you are, 
you're likely to end up with the same 
kind of problem which befalls a pilot 
flying from New York to Washington— 
a side trip to the Twilight Zone. 

Can You Play An Instrument? 

When you've mastered the nuts and 
bolts of your simulator; that is, takeoffs, 
flying and landing, VFR navigation, 
and so on, the next logical step is in- 
strument flying, including using the 
Instrument Landing System at a num- 
ber of airports on the FS2 disk and the 
scenery disks. 

Before you tackle instrument flying 
in bad weather, I suggest that you prac- 
tice radio navigation in fair weather un- 
til it becomes second nature. Start off 
flying directly from beacon to beacon, 
and then graduate to using two bea- 
cons to triangulate your position. Once 
you master that, you're freed from 
"beacon hopping," and you'll gain a lot 
more skill in instrument navigation. 
With practice, and using a combination 
of radio navigation, experience, and a 
little dead-reckoning thrown in for 
good measure, you should become 
quite proficient at droning around the 
countryside, knowing exactly where 
you are at all times. When you get to 
that point, try an instrument landing. 
First try it in clear, calm weather and 
just kill your main window. (It's a lot 
easier to reactivate your main window 
if you get into trouble than it is to reset 
the cloud cover.) 

Instrument landing approaches are 
probably the most difficult aspect of 
the flight simulator to master. It re- 
quires a combination of "flying" skill, 
proflciency at reading and interpreting 
instruments, navigational skills, and 
nerves of steel. Once you do a number 
of successful approaches under ideal 
conditions, toughen the environment 
slightly and do it all over again. Keep 
trying to make things difficult for your- 
self, and don't give up. As with any- 
thing else, constant practice and dili- 
gence will beat raw talent any day. 
(You've got to watch out for the talent- 
ed ones who constantly practice, 
though.) 

Deja Vu City 

For a long time, I've been nursing 
this nagging curiosity about FS2. Just 



how close to reality is the simulator, 
and just how much of what I've learned 
by using F82 would help me to fly and 
navigate a real, honest-to-goodness 
Cessna? Aside from a short stint at the 
stick of a Blanec Sailplane (1 hope I've 
got the spelling right) back in the ear- 
ly 70's, I've never flown an aircraft be- 
fore. So I took my curiosity to a near- 
by flight school and arranged for a 
short flight. I had originaUy planned on 
giving you a detailed comparison of 
FS2 and the real thing, but the flight, 
in it's essence, was simply a reflection 
of the simulator. VFR and radio navi- 
gation were identical, at least as far as 
the mechanics of it. Tuning in a VOR- 
TAC was a bit different than it's done 
in the simulator, in fact, most of the 
differences between the simulator and 
actual flying are either those imposed 
because of the limitations inherent in 
the medium, or in the stylized or sim- 
plified representation of parts of the 
world of flight. 

The instrument panel of the Cessna 
172 was virtually identical to the panel 
depicted in FS2. There were some 
minor variations, of course, such as the 
position of the fuel gauges and the com- 
pass, and the position indicators, 
which didn't exist at all. But the panel 
looked nice and familiar. 

The actual flying of the plane was 
drastically different. Obviously, it 
would be* and I expected as much. In 
this respect the simulator is as close to 
reality as the driving simulators you 
find in an automobile driving school. 
The tactile feedback, and the "seat of 
the pants" feel for the aircraft is some- 
thing that can't be experienced in the 
simulation. The results of physical 
forces acting on the aircraft are some- 
thing which are seen in the simulation, 
and felt in the real thing. And finally, 
of course, the controls in the Cessna 
were inflnately more sensitive than the 
simulator's. Although my head knew 
what had to be done (and in that one 
respect the simulation did help), the ac- 
tual execution of a few simple maneu- 
vers bore no relationship at all to the 
computer simulation. 

Also, there are a myriad of details 
which must be attended to in the 
course of a real flight which are not 
reflected in the simulator, such as ra- 
dio communications and air traffic 
control. 

All in all, however. Flight Simulator 
II is a remarkable piece of work. With 
a little imagination and some home- 
work, you can get a real close idea of 
what it's like to fly a small plane. But 
watch out. It's addictive. 
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GAME 




by Patrick Dell Erai 



Low or 
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Even the stodgiest, "sophisticated" 
computer curmudgeon enjoys an occas- 
sional game against the computer. But 
oftentimes the computer becomes too 
predictable in its play to remain challeng- 
ing. If only a computer could be 
programmed to have the irrational quirks 
of a real human! 

Increasingly, gamesters want to be able 
to play against other people instead of 
Just the computer. With Battle Blips! 
(BB) you have just that option. But unlike 
most other person vs. person games, your 
human opponent doesn't even have to be 
in the same country as you! 

Ilowz'at? Well, you see, BB lets you use 
your modem to play against someone 
else. What, you don't have a modem yet? 
That's okay, BB will still play you a pret- 
ty tough game against the computer! 

BB is a strategy game based on the clas- 
sic game of Battleship. You and your op- 
ponent each have a lOxlO-inch grid on 
which to place your fleet of five ships. 
Then each tries to sink the other's fleet 
first. Each ship can take as many hits as 
it is long. The ships range in length from 



two for a Destroyer tQ five for a Battleship. 

BB was written as a desk accessory, so 
it is available to you at any time you are 
using a GEM program with the menu bar 
accessible. You can start up a game, in- 
terrupt it to go back to your main pro- 
gram, and then click It on again to con- 
tinue from the exact place you left off. 

To install BB, you must copy it to your 
boot disk with the extension .ACC. Then 
turn off your 8T for ten seconds, and turn 
it back on. When you drop down the Desk 
menu, you should see the title "Battle 
Blips!" 

To start playing, click it on. BB will 
work in either mono or medium resolu- 
tion color. 

After clicking BB, you will be present- 
ed with a menu that allows you to "Play 
against computer," "Play as HOST against 
modem," "Play as GUEST against mod- 
em," or "Exit Battle Blips! ..." Move your 
mouse arrow to your choice and click. 

Playing against the computer and ex- 
iting are pretty self-evident. They allow 
you to play the computer only or to 
return to the desktop. 
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When you start playing BB, you will see 
the play screen with two grids separated 
down the middle with a ships-sunk box. 
The grid on the left is your opponent's 
grid, the one on the right is yours. Next 
to the ship names are small empty box- 
es. When the named ship is sunk, a check 
mark will appear in the appropriate box. 
At the bottom of the screen is the mes- 
sage window. Here's where you will see 
whose turn it is, if the shot is a hit or a 
miss, etc. 

Whether playing the modem or playing 
the computer, you must first place your 
ships on your grid. Move the dark cursor 
to the square that marks one end of your 
ship. Use the cursor keys to move around, 
or optionally, you may use the 1, 2, 3 and 
5 keys of the keypad. Note that the key- 
pad option is laid out and used exactly the 
same as the cursor keys, but places the 
Enter key right under your little finger 
so you don't have to move your hand to 
place a ship or make your shot. 

Your cursor will jump to the opposite 
side of the grid if you move it off an edge. 
When the cursor is at the desired posi- 
tion, press RETURN or ENTER. If the ship 
you are placing will fit only down or 
across, it will be placed in position. If it 
could fit in both directions, you will be 
asked to indicate which you want. Press 
the down arrow (or 2 on the keypad) to 
indicate down, or press the right arrow 
(or 3 on the keypad) to indicate across. 
Pressing RETURN or ENTER is not neces- 
sary to indicate the direction to lay the 
ship. 

If the ship you are placing does not fit 
in either direction, you will be told. Note 
that another ship may be in the way, not 
just the edge of the grid. Simply move to 
another location and try again. 

After you have placed your ships, there 
will be an invisible (but fair— trust me!) 
coin toss to see who will go first. If you 
are playing the modem as a Host (don't 
panic, you'll see what that means. . .), 
then your guest will make the call, and 
you will be told the outcome. 

Once you and your opponent have 
placed your ships on your own grids . 
it is time to do your best to sink your op- 
ponent's fleet before he/she/it sinks 
yours. When it is your turn, your cursor 
will be placed in your opponent's grid. 
Move it to where you want to take a shot 
and press RETURN or ENTER. On your 
opponent's turn, you will see him/her/it 
move his/her/its (oh, the heU with it!) cur- 
sor to where she will take her shot. The 
message box will indicate whose turn it 
is, whether the shot taken is a hit or a 
miss, and, if necessary, if a hit has sunk 
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the ship. 

Squares that have not been shot at have 
an outlined cross in them. Shots that hit 
are marked with an oval with an "X" in 
it (you may recognize it!), and misses are 
shown with blank squares. If you take a 
shot at a square that you have already 
shot at, you will be told. Then you get 
another chance. 

You may exit back to the desktop by 
pressing Undo. If you are playing the 
computer alone, when you come back to 
BB you will have the option of continu- 
ing the game or starting a new game. Con- 
tinued games pick up right where you left 
off. 

Playing the modem takes a little more 
explanation. First you boot up with BB in- 
stalled as a desk accessory. Then you 
enter your terminal program, make a call 
to your waiting friend (or answer a call 
from your calling friend), and establish 




your modem connection. You may have 
your terminal paramaters set any way 
you want. BB doesn't care what baud, par- 
ity, etc. you choose, just so long as you 
can communicate with your opponent 
through your terminal program. 

You and your friend need to agree be- 
fore entering BB who wUl be the host and 
who wiU be the guest. Needless to say, you 
have to have one of each before you can 
get anjrwhere. It's probably a good idea 
to make the caller the host and the an- 
swerer the guest, but it doesn't matter to 
BB, so long as you do have one of each. 

The reason BB was written as a desk ac- 
cessory is so that you may use your 
favorite terminal program to make the 
connection with your modem. 

(Let's face it, the terminal program you 
have and love is far better and more 
familiar than any kind of simple termi- 
nal program I would have put together. ) 
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After you and your friend have con- 
nected and established who will be the 
guest and who will be the host, you both 
need to access the menu bar by whatever 
means is necessary with your terminal 
software. Flash users wUl have to press 
the right mouse button. VT-52 Emulator 
users will have to press UNDO, dumping 
you back to the desktop but not discon- 



Listing 1: 
Pascal 

tSA+,0-, S18J 

C 66/21/87 2e:51:28 } 

PROGRAH Battle-Blips S 

CONST 

($1 Sp-pasc9lSGEHC0MST.PAS > 
AC-OPEN = 48 : 
AC-CLOSE= 41 : 

OR = 13 ; 

UNDO = tGieo ; 

LEFT = $4b8e ; ONE = t6d31 ; 

POUN = fS888 J TUO = *M2 I 

RIGHT = *4dB8 } THREE = «Gf33 I 

UP = S480B ; FlUE = tGbSS I 

RETURN = »lc8d ; ENTER = «72Bd i 



necting the line. Mi-Term and other ter- 
minal programs have the menu bar avail- 
able at all times. 

Once back at the menu bar, drop down 
the Desk menu and click on Battle Blips. 
When you see BB's options, click on the 
appropriate choice (dictated by whether 
you are the designated host or guest). 

Then place your ships on your grid. 
When both people have completed that, 
the information will be passed back to the 
host computer and the guest will choose 
heads or tails to determine who will start 
first. Then the play begins! 

You may at any time suspend the game 
and return to the desktop or the termi- 
nal program that you launched BB from. 
Then you and your friend may type mes- 
sages back and forth, perhaps con- 
gratulating each other on a game well 
played. 

You both may re-enter the game in the 
same way as you started it. Of course, you 
will be presented with different options 
from BB. You may continue the game, or 
exit. You don't have the option of start- 
ing a new game at this point, just so some- 
one doesn't "accidentally" make a mis- 
take and trash the game in progress. Re- 
entering the game puts you back at ex- 
actly the same point that you had sus- 
pended the game from. 

A Few Technical Notes 

Battle Blips! is written in Personal Per- 
sonal Pascal v.1.11 from O.S.S., Inc. It was 
developed first as a stand-alone program 
for ease of testing. When it was working 
weU, it was converted to a desk accesso- 
ry using built-in commands available in 
Pascal 1.11 or later versions. 

You can re-compile the source into a 
stand-alone application by commenting 
out the first line: 

($A-H, D-, $20) 
and commenting out the existing last 
block and installing the already com- 
mented out last block. If you do it right, 
it really takes only a few keystrokes! 

While most of BB is written in fairly 
standard Pascal parlance (hey,what do I 



know?), there are a couple of tricks worth 
looking at. 

The message window used shows an in- 
teresting use of an undocumented proce- 
dure of Personal Pascal— Ob|_Draw. 
With it, you can have the AES draw your 

dialogs just like in the call Do Dialog. 

But after it draws the dialog, it returns 
to the calling program. Then you can 
manage the dialog yourself 

Check the procedure Pause. There 
you see how to enter Supervisor mode in 
Personal Pascal and access the timer for 
precise timing. From Supervisor mode 
there is no limit to the fun you can have 
crashing your system! 

It was decided to use BIOS calls for 
modem input/output rather than the 
traditional Pascal system of ResetAVrite. 
While the traditional Pascal means is an 
excellent learning tool, it just gets in the 
way (as far as I am concerned) for real ap- 
plications. Besides, there is no provision 
for determining whether there is data 
waiting on the modem without using the 
Bconstat call. 

BB should work just fine through net- 
working systems such as CompuServe 
and Delphi. It doesn't use any but the 
standard readable ASCII characters for 
sending data, so the filtering common to 
such networks would not hinder BB. 

To use a network, you and a friend 
would have to call it at a given time. Then 
enter into a private conference with each 
other. Then go for it! 

Why would you want to use a network 
for such a thing? To keep Ma Bell from 
taking all your money when playing long- 
distance. Most cities have local access 
numbers to call the networks. The local 
call plus the network charges might be 
lower in some instances than long- 
distance direct calls. 

Check it out . 



My thanks to O.S.S. in general and 
Mark Rose in particular for the little 
tricks used to coerce Pascal to do what is 
needed. 
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DESTROVER 




1 : 


SUBMARINE 




2 ; 


CRUISER 




3 ; 


BATTLESHIP: 


4 : 


A-CARRIER 




5 ; 


HUMAN 




e ; 


COMPUTER 




1 ; 


TOTAL 




8 ; 


SHIPS 




8 ; 


SHOTS 




1 ; 


NOSHIP 




' + • ; 


NOSHOT 




■ + ■ i 


HIT 




5 ) 


MISS 




i 



TYPE 

CSI Sp-pascalSGEMTVPE.PAS > 

grid = Packed Array [ 8.. 9, 8.. 9, SHIPS.. SHOTS 1 of Char ; 
Str5 = StringtS] ) 

UAR 

ns9 s nessage-buf f er ; 

window, ap-id : Integer I 

title 1 Str255 J 

dunny s Integer ; 

nsg-box : Dialog_Ptr i 

nsg-idx : Array[e..3] of Integer ; 

cnp-grid, hnn.grid : grid ; 

strength : Array! HUMAN. .COMPUTER, TOTAL. .A-CARRIER 1 OF Integer : 

ship-nane : Array! DESTROVER .. A-CARRIER ] OF StringllG] ; 

hunan_turn : Boolean ; 

unresolved-hits : Integer ; 

pattern : Boolean ; 

hnn-col, hnn-row s Integer ; 

cnp-col, cnp-row : Integer ; 

rez : Integer ; 

cont-gane, stop : Boolean 1 

play-node : Char i 

ISl \p-pascalSGEMSUBS.PAS } 

FUNCTION getrez •• Integer J 
XBIOSC 4 1 ; 

FUNCTION Menu-RegisterC id! Integer ; UAR nane ! Str255 ) ! Integer 
EXTERNAL ; 

PROCEDURE Obj-Draw( dialog : Dialog-Ptr i 
start, depth, 
X, y,w, h : Integer 1 i 

EXTERNAL ; 

FUNCTION event-key : Integer ; 
VAR event, key : Integer 1 

BEGIN 

event := get-event (E-Keyboard | E-Tiner, 0, 0, 0, B, 

FALSE, e, 0, 8, 0, FALSE, 8, 8, 0, 8, 

nsg, key, dunny, dunny, dunny, dunny, dunny ] ; 

IF event S E-Keyboard <> B THEN 
event-key := key 

ELSE 

event-key != -1 < 

END ; 

FUNCTION bconstat( device : Integer ) i Boolean ; 
BIOSC $81 ] ; 

FUNCTION bconinC device i Integer ) : Long-Integer : 
BIOSC $02 ) i 

PROCEDURE bconoutC device, c : Integer 1 ; 
BIOSC $83 ) j 



FUNCTION superC x: Long-Integer ) : Long-Integeri 
GEMDOSC $28 }: 

FUNCTION tine : Long-Integer; 

{ returns systen tiner ticks 266/second resolution } 

TVPE 

Long-pointer = ^long-integer i 

UAR 

ssp s Long-Integer; C save old supervisor stack pointer } 

hZ-288 ! RECORD 
CASE Boolean OF 

TRUE ! C li Long-Integer ]; 

FALSE : C p: long-pointer 1; 
END ; 

BEGIN 

ssp I = SuperC 8 )) ( save supervisor stack., enter super node > 

hz-2e8.1 1= $4ba) C point at 288 hertz tiner > 

{$p-} { turn pointer checking off > 

tine ■= hz-2e8.p^: t get the longword at that location > 

{$p=} ( restore old value of pointer checking } 

ssp != SuperC SSP ); I restore supervisor stack... enter user node > 

END ; I tine > 

PROCEDURE do-close : . . 

BEGIN 

IF window <> no-window THEN BEGIN 

closc-windowC window ) ; 

delete-windowC window ] ; 

window != No-Uindow ; 

stop := TRUE ; 

show-nouse ; 
END ) 
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END ; 

PROCEDURE out_noden( trash s strS ] ; 
UAR ctr ! Integer t 

BEGIN 

bconoutC 1, ordC play-node ) 1 ; 
ctr := 1 ; 

UHILE ctr <= Length! trash } DO BEGIN 

bconoutC 1, ordCtrashCctr]} ] ; 

ctr 1= ctr+1 ; 
END ; 

bconoutC 1, CR J i 
END ; { out_naden > 

PROCEDURE noden-errorC error : Integer 1 : 
UAR junk : Integer : 
trash : Str2S5 ; 

BEGIN 

trash ' [1] [ IGane suspended I by ' ; 
CASE error OF 

e : trash := ConcatC trash, 'opponent'] ; 

1 i BEGIN 

out-nodenC 'SS' ] ; 
trash i= ConcatC trash, 'you'} ; 
END ; 

2 : BEGIN 

cont-gane := FALSE ; 

trash := ' [31 [ IFatal data errorlduring noden input' ; 
END ; 
END ; { case > 

trash := ConcatC trash, '.| IC okay ]' ) ; 
junk := do-alertC trash, 1 1 ; 
do_close i 
END i { noden_error > 

PROCEDURE in-nodenC UAR in_str : StrS ] ; 
UAR ctr : Integer i 

done : Boolean ; 

key ! Integer : 

s : Char ; 

trash : Str255 ; 

pace : Long_Integer ; 

BEGIN 

REPEAT 

pace := tine + 1200 : 
trash i= '' ; 
done := FALSE ; 
REPEAT 

key := event-key ; 
done := Ckey = UNDO} : 
IF done THEN 

noden_errorC 1 } 
ELSE IF bconstatCl} THEN BEGIN 
s i= chrC bconinC 1 }} ; 
done := C s = chrCCR} ] ; 
IF HOT done THEN 

IF C s IN ['0'..'9', 'A'.."Z' n THEN 
IF C Length C trash } < 254 ] THEN 

trash := ConcatC trash, s } 
ELSE 

trash := •' ; 

END 

ELSE IF tine > pace THEN BEGIN 
IF in-str = 'OK' THEN BEGIN 
out-nodenC in-str } : 
pace := tine * 1200 ; C 6 seconds > 

END ; 
UNTIL done ; 
IF NOT stop THEN BEGIN 

?2"S '= iLb*"'^''' } > 1 } AND C Length C trash } < 5 }} 

IF done THEN 

IF play-node = 'H' THEN 

done := C trash 111 = 'G' } 
ELSE IF play-node = 'G' THEN 
done :r c trash [1] = 'H' } ; 
IF done THEN 

IF in-str <> 'OK' THEN 

done 1= C PosC 'OK', trash } = 6 } ; 

END / 
UNTIL done ; 
IF NOT stop THEN BEGIN 

IF in-str = 'OK' THEN 
out-nodenC in-str } ; 

in_str := CopyC trash, 2, Length Ctrash} -1 ] ; 

IF in-str r 'SS' THEN 
noden-errorC 0 } i 

END : 
END 1 { in-noden > 

PROCEDURE drau-nsg-boxC level : Integer ] : 
BEGIN 

^^I^Obj-DrawC nsg_box, level, level, 8,0,640,640 ] ; 

PROCEDURE nessageC nsg : Str255 ; level : Integer ] ; 
BEGIN 

level •■= nsg-idxCIevell : 

set_dtextC nsg-box, level, nsg, 3, TE-CENTER ] ; 
draw-nsg_box C level ) ; 
END ; 

PROCEDURE wait-opponent : 
UAR ndnstr : StrS ; 
BEGIN 

IF play-node <> 'C THEN BEGIN 
drau_nsg-boxC 8 ) ; 
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ndnstr 'OK' ■ 
out_noden( ndnstr ] ; 

nessaseC 'Uaiting for your opponent...', 2 1 ; 
REPEAT 

ndnstr ■"= 'OK' ; 

in_noden( ndnstr 1 1 
UNTIL stop OR ( ndnstr = 'OK' ) ; 
END ; 

END ; { wait-opponent } 

PROCEDURE drau-bkgrnd i 
MAR X, y,u, h i Integer J 
BEGIN ^ . 

work_rect( window, x,y,w,h J ; 

set-clip ( X, y,w, h 1 ; 

Draw_node ( 1 ] ; 

Paint-Style(14) 1 

Paint-ColorC BLACK ] ; 

Paint-RectC x, y, w, h 1 ; 
END ; ( draw-bksrnd > 

PROCEDURE do-open ; 

UAR nenu-screen : Dialos-Ptr ; 

junk i Integer : 

trash ! Str2S5 ; 

nenu-offset : Integer i 

ready : Boolean 1 

BEGIN 

window := new-window( G-NAME, 
title, 

8, e, e, a ) ; 

open-window ( window, B, 8, 8, 6 ) ; 
hide-nouse I 
stop := FALSE ; 
draw-bkgrnd i 

REPEAT 

ready := TRUE : 

nenu-screen := new-dialogC 9, 6,8,45,28 1 ; 

junk != add-diten(nenu-screen, g-text, none, 8, 1, 44, 1, 8, 256 ) • 
sct-dtcxt( nenu-screen, junk, 'B attle Blips I ' , 3, TE-CENTER ) 
junk := add-diten(nenu-screen, g_text, none, 8, 2, 44, 1, 8, 256 1 i 
sct_dtext( nenu-screen, junk, 'version 1 .5 ' , 5, TE_CENTER }; 
trash != Concatt 'Copyright ',chrtl89),' 1987 ') J 
trash := ConcatC trash, 'P.L. Dell' 'Era' 3 : 
junk s= add-diten(nenu-screen, g_text, none, 8, 3, 44, 1, 8, 256 ) > 
set-dtextC nenu-screen, junk, trash, 3, TE-CENTER ); 

trash := ConcatC 'Portions copyright ',chrC189},' CCD and OSS, Inc.' 1 
junk := add-diten (nenu-screen, g_text, none, 8, 4, 44, 1, 8, 256 ) ! 
sct-dtext( nenu-screen, junk, trash, 3, TE-CENTER )i 

IF NOT cont-gane THEN BEGIN 

nenu-Offset := add-diten (nenu-screen, g_button, 

SELECTABLE I DEFAULT | TOUCH-EXIT, 8, 6, 28, 2, 8, 256 ] J 

set-dtextC nenu-screen, nenu-offset, 'Play against conputer', 
3, TE-LEFT 1; 

junk := add-ditenCnenu-screen, g-button, 

SELECTABLE | TOUCH-EXIT, 8, 9, 28, 2, 8, 256 ) ; 
set-dtcxtC nenu-screen, junk, 'Play as HOST against noden' 

,3, TE-LEFT ) 1 
junk := add-diten (nenu-screen, g-button, 

SELECTABLE I TOUCH-EXIT, 8, 12, 28, 2, 8, 256 1 ; 
sct-dtext( nenu-screen, junk, 'Play as GUEST against noden' 
,3, TE-LEFT ) ; 

END 

ELSE BEGIN 

nenu-Offset := add-diten (nenu-Screen, g_button, 

SELECTABLE I DEFAULT | TOUCH-EXIT, 8, 7, 28, 2, 6, 256 ] ; 
set-dtextC nenu-screen, nenu-offset, 'Continue Gane' 

,3, TE-LEFT ) ; 
junk := add-ditenCnenu-screen, g_button, 

SELECTABLE I TBUCH-EXIT, 8, 11, 28, 2, 8, 256 1 ; 
set-dtcxt( nenu-screen, junk, 'Start Hew Gane' 

,3, TE-LEFT ) ; 
IF play-node <> 'C THEN 
Obj.SetstateC nenu-screen, junk, DISABLED, FALSE ] ; 
END ; 

junk := add-diten (nenu-screen, g_button, 

SELECTABLE I TOUCH-EXIT, 8, 15, 28, 2, 8, 256 ] ; 

set-dtextC nenu-screen, junk, 'Exit Battle Blips! ...' 
,3, TE-LEFT J ; 

junk != add-diten Cnenu-screen, g_text, none, 8, 18, 44, 1, 8, 256 3 ; 
set-dtextC nenu-screen. Junk, 

'Mhile playing, press [UNDO] to exit gane .', 5, TE-CENTER 1 ; 

center-dialogC nenu-screenl i 
show-nouse ; 

junk i= do-dialogC nenu-Screen, 8 1! 
hide-nouse > 

delete-dialog ( nenu-screen ) ; 

IF NOT cont-gane THEN 
CASE junk - nenu_offset OF 
8 : play-node := 'C 

1 s play-node := 'H' 

2 : play_node := 'G' 

3 : do-close ; 

END < case } 
ELSE 

CASE junk - nenu_offset OF 
8 i ; 
1 : BEGIN 

IF play-node = 'C THEN BEGIN 
cont-gane := FALSE ; 
ready := FALSE ; 
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END ; 
END ; 
2 : do_close i 
END ; { case } 
UNTIL ready ; 
IF NOT STOP THEN 
draw-bkgrnd ; 
END ; { do_open } 

PROCEDURE pause ( seconds : Integer ] ; 
UAR dunny : Integer ; 

finish : Long^Integer ; 
BEGIN ( pause } 

finish := secands«2SB ; 

dunny != get_event( E_Tiner, 8, B, 8, finish, 

FALSE, 8, 8, 8, 8, FALSE, 8, 8, 8, 8, 
. nsg, dunny, dunny, dunny, dunny, dunny, dunny 3 

FUNCTIBN randC nax : integer ) : integer > 

FUNCTION randon : I ong_ integer ; 
XBIOS ( 17 1 ; 

BEGIN 

IF nax = 8 THEN 

rand := 8 
ELSE 

_ rand := intt randon MOD nax ) ; 

PROCEDURE init-grids ; 
VAR X, y, z : Integer ; 

BEGIN 

IF NOT cont_gane THEN BEGIN 
FOR X := 8 TO 9 DO 
FOR y := 8 TO 9 DO 

FOR z := SHIPS TO SHOTS DO BEGIN 
cnp.gridC x, y, z ] := NOSHOT ; 
^^^hnn_grid[ x, y, z I := NOSHOT ; 

FOR X := HUMAN TO COMPUTER DO 

FOR y := TOTAL TO A-CARRIER DO BEGIN 
CASE y OF 

TOTAL : strength [x, y] !z 5 i 
DESTROVER : strength Ix, y] != 2 ; 
SUBMARINE : strength Ix, y] := 3 ; 
CRUISER ! strength [X, y] := 3 ," 
BATTLESHIP! strength tx, y] != 4 ; 
A-CARRIER ! strength [x, y] := 5 ; 
END ; { case } 
END ; 

unresoIved_hits := 8 ; 
pattern := Odd( randC 188 1) ; 
hnn-col := 8 ; 
hnn_row := 8 ; 
cnp_coI :r 8 ; 
cnp-rou := 8 : 
END ; 

END ; { init.grids } 

PROCEDURE show-sunked ; 
UAR ctr, ctr2 : Integer ; 
BEGIN 

text_style( THICKENED ) i 

FOR ctr := HUMAN TO COMPUTER DO 

FOR ctr2 != DESTROVER TO A_CARRIER DO 
IF strength! ctr, ctr2 ] = 8 THEN 

draw-string C 376-118»ctr, 42»rez+12»rez»tctr2-13 , chr C8) ) 
text_style( NORMAL ) ; ' 

END i { show-sunked > 

FUNCTION nane-rankC c : Char ) : Integer ; 
UAR ctr : Integer ; 

trash : String [161 ; 
BEGIN 

ctr != 8 ; 

REPEAT 

ctr := ctr+1 ; 

trash := ship.naneCctrl ; 

UNTIL trash [11 = c ; 

nane.rank i= ctr ; 
END : 

PROCEDURE show-synboK Inrgn, x, y : Integer ; k : Char ] ; 
BEGIN 

text-StyleC OUTLINED I THICKENED ] ; 

IF k = NOSHOT THEN 

text-color C GREEN ) 
ELSE IF k = chrCHIT] THEN BEGIN 

text-coIorC RED ] i 

text-style ( NORMAL ) : 

END 
ELSE 

text-color ( BLACK 1 1 

draw-stringC lnr9n+24»x, 33»rez<'12»rez«y, k ) J 
END ; ( show-synbol } 

PROCEDURE setup-screen ; 

VAR col, row, row2, ctr, ctr2, of f set ! Integer ; 
x,y,w, h : Integer ; 
Itr : Char ; 
init-str : String [381 ; 
trash i Str25S ; 

PROCEDURE show-setup ; 
VAR X, y : Integer ; 
c : Char ; 
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BEGIN ( shou-setup > 
FOR X := e TO 9 DO BEGIN 
FOR y :r 8 TO 9 DO BEGIN 

c := cnp-gridC x,y, SHOTS 1 ; 
shou-synboK 16, x, y, c ] : 

IF hnn_9rid[ x, y, SHIPS ] <> NOSHIP THEN BEGIN 
IF hnn-gridE x, y, SHOTS 1 - NOSHOT THEN BEGIN 

trash i= ship-nanel nane_rankChnn_9ridC x, y, SHIPS HI 
c := trash [11 : 

END 

ELSE 

c := chrCHITl ; 

END 

ELSE 

c := hnn_9rid[ x, y, SHOTS 1 i 
shou-synboIC 4B8, x, y, c 1 ; 
END ; 
END : 

text-color ( BLACK 1 : 
text-style ( NORMAL 1 ; 
END ! I show-setup } 

BEGIN 

drau-bkgrnd < 
Line-ColordI ; 
Line-Style CI) ; 
Paint-StyleCl) ; 
Paint-Color CO] ; 
Paint-OutlineC TRUE 1 ; 

Paint-Rectt 8, 24»rez, 624, 128»reztl J 
Frane-Rect( 7, 23»rez+l, 626, 121»rez ) 
Frane-Rect( 8, 24»rez, 624, 128»rez+l ) 
FOR Ctr2 1 TO 2»rez DO 

lineC 9+ctr2»2, 144«reztctr2, 635, 144»rez+ctr2) ; 
FOR ctr2 != 8 TO 3 DO 

lineC 633+ctr2, 24»reztl+ctr2, 633+ctr2, 146»rez J ; 

FOR ctr2 := e TO 1 DO BEGIN 
offset := 384»ctr2 i 
row != 36«rez 1 
col := 32+offset ; 
FOR ctr := 1 TO 9 DO BEGIN 

lineC 8+of f set, row, 246+offset, row J ; 
linet col, 24«rez+l, col, 144«rez ) ; 
row i- row + 12*rez ; 
col := col * 24 ; 
END ; 
END 1 

row i= 24»rez+l ; 
row2 i= 144«rez ; 
lineC 247, row, 247, row2 1 ; 
lineC 248, row, 248,row2 1 i 

Iine( 392, row, 392, row2 } ; 
lineC 393, row, 393, row2 ] ; 

row := 23»rez+l J 
row2 := 128 • rez+1 1 
Frane-RectC 258, row, 141, row2 1 1 
Frane-RectC 251, row+rez-1, 139, row2+rez-l ) ; 
init-str := Concatt chrt4),' Ships Sunk: ■,chr(3J ) 
draw-stringC 256, 31«rez, init-str } ; 

row != 33«rez+l ; 
row2 := 181«rez > 

lineC 272, row, 272,row2 1 ; 

lineC 273, row, 273, row2 ) ; 

lineC 368, row, 368, row2 ] ; 

lineC 369, row, 369,row2 1 ; 

row := 33»rez 1 
FOR ctr ;= 1 TO 4 DO BEGIN 

lineC 252, row, 398, row) i 

IF rez = 2 THEN 

lineC 252,row+l, 398, row+l) ; 

draw-stringC 288, rowtl8*rez, ship-nane [ctr] ) ; 

row := row+12Krez i 
END ; 

linet 252, row, 398, row) : 
IF rez = 2 THEN 

lineC 252, row+l, 398, row+l) ; 
draw-strinyC 288, row+18<rez, 'Aircraft' ) ; 
draw-StringC 288, row+18»rez, 'Carrier' ) ; 
lineC 252, row+28»rez, 398, row+28»rez) ; 
IF rez = 2 THEN 

lineC 252, row+28»rez+l, 398, rowt2B»rez+l) ; 

lineC 252, row+21»rez+l,398, row+21»reztl) ; 
IF rez = 2 THEN 

Iine( 252, row+22»rez,398, row+22»rez) J 

text-style( THICKENED ); 

draw-strinyC 264, rowt34»rez+l, 'Opponent' ) 

Iine( 252, 123»rez, 398, 123»rez) ; 
IF rez = 2 THEN 

lineC 252,247,398,247 ) ; 
draw-stringC 296, 135»rez, 'V o u') ; 

text-style C NORHAL ): 

draw-StringC 252, row+34»rez+l, chrt4) ) ; 
draw-stringC 388, 135Mrez, chr(3) ) ; 
show-setup i 
show-sunked ; 
END ; ( setup-screen ) 
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PROCEDURE hunan-inputC UAR c,r ! Integer; Inargn: Integer ) ; 
UAR key : Integer ; 

offset : Integer ; 

ndnstr : StrS ; 

x_inc,y_inc : Integer ; 

PROCEDURE paint-cursor ( node : Integer ] : 

VAR X, y, u, h ■' Integer ; 

BEGIN 

draw_node( node 1 ; 

X := of f set'i'CK24 ; 

y ■■= r»12Krez + 24«rez + 2 ; 

w 19 <:8»3-5) ; 

IF rez - 1 THEN 
h := 9 

ELSE 

h := 21 i 

paint_rect(x, y,u, h) ; 

IF x_inc + M_inc <> 6 THEN BEGIN 
c '•= c * x_inc 1 
r := r + g_inc ; 

IF c < 8 THEN c != 9 

ELSE IF c > 9 THEN c := 8 

ELSE IF r < 8 THEN r != 9 

ELSE IF r > 9 THEN r := 6 ; 

x != of f set'i'C«24 J 

y != r»12»rez + 24«rez ♦ 2 ; , ' 

paint-rectCx, y, w, h) ; 
END ; 
END ; 

BEGIN 

paint-Style CI] ; 
Paint-OutlineC FALSE ) ; 
offset := Inargn»384 + 11 : 
x-inc s= 8 ; 
y-inc := 8 ; 
paint-cursor ( 3 ] 1 
REPEAT 

x_inc 1= 8 ; 
y-inc != 8 ; 
key i= euent-key ; 
IF bconstat(l) THEN 

IF chrCbconinCD) ='$' THEN 
noden-errorC 8 1 ; 

IF HOT STOP THEN BEGIN 

IF (key = LEFT) OR Ckey = ONE) THEN 

x-inc != -1 
ELSE IF Ckey = RIGHT) OR Ckey - THREE) THEN 

X-inc :r 1 
ELSE IF Ckey = DOUNl OR Ckey = TUO) THEN 

y-inc := 1 
ELSE IF (key = UP) OR Ckey = FIUE) THEN 

y-inc ••- -1 
ELSE IF key = UNDO THEN 

IF play-node = "C THEN 
do-c lose 

ELSE 

noden-errorC 1 ) 
ELSE key := key S $8f ; 
IF X-inc + y-inc <> 8 THEN BEGIN 

paint-cursor C 3 ) ; 

IF C HOT STOP) AND C play_node <> 'O AND C Inargn - 8 ) AND 
C key <> CR ) THEN BEGIN 

ndnstr i= ConcatCchrC ordC'B') | c ),chr( ordCB') I r ) ); 
out-noden( ndnstr ) ; 
END ; 
END ; 
END ; 

UNTIL ( key = CR ) OR stop ; 
IF NOT stop THEN 

paint-cursor ( 1 ] : 
drau-node(l) ; 
END ; { hunan-input ) 

PROCEDURE hunan-setup ; 

UAR ship, ship-length, ctr : Integer ; 

ok, across : Boolean ; 

col, row, X, y ; Integer ; 

trash, trash2 : Str2SS : 

c : Char ; 

key : Long- Integer ; 

FUNCTION roon-available( x-inc, y-inc : Integer ) : Integer i 
UAR ctr, X, y ; Integer ; 

done : Boolean ; 
BEGIN 

X := col ; 

y row ; 

ctr != 8 ; 

REPEAT 

done := (x>9) OR (y>9} : 
IF NOT done THEN BEGIN 

done := C hnn-grid [x, y, SHIPSl <> NOSHIP ) ; 
IF NOT done THEN BEGIN 
ctr != ctr ♦ 1 ; 
x i= x -I- X-inc ; 
y := y -f y-inc ; 
END ; 
END ; 
UNTIL done ; 

roon_avai lable ;= ctr ; , 
END ! C roon_avai lable ) 

BEGIN ( hunan-setup } 

draw_nsg_box C 8 ) ; ■ 
draw-nsg-boxC nsg-idxCB] ) i 
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col := e i 
row 8 J 

trash2 :="Position your ships- J 
FDR ship ■■- DESTROVER TO A_CARRIER DO BEGIN 
IF NOT stop THEN BEGIN 
CASE ship OF 

DESTROVER : ship-length := 2 ; 
SUBMARINE : ship-length := 3 ; 
Otherwise : ship-length := ship ; 
END : { case > 
REPEAT 

trash != ConcatC ship_nane[ship], ' is ', chr(ship_lensth+48), 

' units long . ' ) ; 
nessageC trash2, 1 1 > 
nessageC trash, 2 ] ; 

obj_setstatet nsg.box, nsg-idx[3], NORMAL, FALSE J ! 
hunan-inputC col, rou, 1 ) ; 
IF NOT stop THEN BEGIN 

ok != TRUE ; . , ,., 

across := Croon-avai lable C 1, 8 J >= ship-length) ; 
IF across THEN BEGIN 

IF roon-availableC8, 1) >= ship-length THEN BEGIN 
trash := ConcatC ■[', chr t3J ,"] Across or '3 ; 
trash ConcatC trash, ■ C, chrC2J, 'IDoun?') ; 
nessageC trash, 3) ; 
REPEAT 

key := event-keg S 
UNTIL ( keg = RIGHT ] OR C keg = THREE 1 

OR C keg = DOWN ] OR C keg = TUO ) ; 
across := C keg = RIGHT ] OR C keg = THREE 1 ; 

END 

END 

ELSE IF roon-availableCe, 11 < ship-length THEN 
ok := FALSE J 

IF NOT ok THEN BEGIN , , , 

shou-synbolC 488, col, rou, hnn-grid[ col, row, SHIPS J 1 ; 

text-stgleCNORMAL ) : 

text-color C BLACK ] ; 

trash2 i- ' Ship can"'t fit there. ' ; 

obj-setstateC nsg-box, nsg-idx [31, SELECTED, FALSE } i 

nessageC trash2,3 ] ; 

END 

ELSE 

nessageC ' ',3 1 J 
trash2 := "Next ships' ; 
END : 
UNTIL ok OR stop ; 
IF NOT stop THEN BEGIN 

trash != ship-nanel ship 1 > 
c := trash [11 : 

text-StgleC OUTLINED I THICKENED 1 i 
FOR ctr := 8 10 ship-length-1 DO 
IF ACROSS THEN BEGIN 

hnn-gridi col+ctr, row, SHIPS I := c ; 

show-sgnbolC 488, coHctr, row, c 1 ; 

END 

ELSE BEGIN 

hnn-gridl col, row+ctr, SHIPS ] s= c ; 

show-sgnbolC 488, col, row-^ctr, c 1 1 
END ; 

text-stgleC NORMAL 1 : 
END i 
END i 
END ; 

END ; { hunan-setup 1 

PROCEDURE conputer-setup ; 

WAR ship, ship-length, ctr : Integer ; 

trash ! String ; 

x,g s Integer ; 

ndnstr : Str5 ; 

PROCEDURE set-position ; 
UAR ctr s Integer ; 

ok, across : Boolean ; 

col, row, x, g, x_inc, g-inc ! Integer J 
c : Char ; 

adjacent : Integer ; 
PROCEDURE check-adjacentC cax, cag : Integer 1 ; 
BEGIN 

IF Ccax>=81 AND Ccag>=8] AND Ccax<=91 AND Ccag<=91 THEN 
IF cnp-gridi cax, cay, SHIPS 1 <> NOSHIP THEN 
adjacent := adjacent * 1 ; 
END ; < check-adjacent } 

BEGIN { set-position > 
REPEAT 

across := OddCrandCieSll ; ' 
x-inc s= 8 ; 
g-inc := 8 ; 

row := randClBl ; 
col := randC181 ; 
IF across THEN BEGIN 

ok := C col * ship-length < 18 1 : 

x-inc := 1 ! 

END 

ELSE BEGIN 

ok := C row * ship-length < 18 1 : 

g-inc := 1 ! 
END ; 

IF ok THEN BEGIN 
X := col : 
g := row ; 

FOR ctr := 1 T8 ship-length DD BEGIN 

IF cnp-gridI x, g, SHIPS ] <> NOSHIP THEN 

ok := FALSE : 
X := X * X-inc ; 
y := g * y_inc ; 
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END ; 
END : 

IF ok THEN BEGIN 
adjacent := e ; 
X := col-x_inc ; 
U := row-y_inc ; 
check_adjacent( x, y I ; 

X := col + x-inc»C ship_length-l ) ; 
i| ;= row + y-inc»C ship_len9th-l J ; 
chack-adjacentC x, y 1 ; 

X := col ; 
U := row : 

FOR ctr ;= 1 TO ship-Iength DO BEGIN 

check-adjacent ( x-B_inc, y-x-inc ) ; 

check-adjacent ( x+y-inc, y-fx-inc ] : 

X := X + x-inc S 

y := y -f y_inc ; 
END ; 

ok := ( adjacent = B ) ; 
IF NOT ok THEN 

ok i= C rand (1881 > adjacent + 92 ] : 

END ; 
UNTIL ok ; 

trash := ship_nane[ ship ] ; 
c := trash [1] : 

FOR ctr := 8 TO ship-length-1 DO 
IF ACROSS THEN 

cnp_grid[ coltctr, row, SHIPS I != c 
ELSE 

cnp-gridi col, row+ctr, SHIPS 3 := c ; 
END ; { set-position > 

PROCEDURE send-hnn_grid ; 
UftR X, y : Integer ; 
BEGIN 

FOR X s= 8 TO 9 DO 
FOR y := 8 TO 9 DO 

IF hnn-gridC x,y, SHIPS 1 <> NOSHIP THEN BEGIN 
ndnstr := ConcatC chr( x | ordC'O'}], 
chrC y | ordCB')], 
hnn-gridC x,y, SHIPS] ] ; 
out_noden( ndnstr ] ; 
END ; 

END ; { send-hnn-grid } 

PROCEDURE receive_cnp-grid ; 
UAR X, y, ctr : Integer ; 
BEGIN 

trash := 'Receiving opponent' 's fleet location.' ; 
nessageC trash, 2 )i 
FOR ctr ■■- I TO 17 DO 

IF NOT stop THEN BEGIN 
in_noden( ndnstr ) ; 
IF NOT stop THEN BEGIN 

X := ordC ndnstrll]] S Sf : 
y := ord( ndnstr[2]] S Sf ; 
cnp-grid[ x, y, SHIPS ] := ndnstr[3] i 
END ; 
END ; 

END ; C rec ieve-cnp-grid > 

BEGIN { conputer-setup } ' 
IF play_node = 'G' THEN BEGIN 
send-hnn-grid ; 
receive-cnp_grid ; 

END 

ELSE IF play-node = 'H' THEN BEGIN 
receiue-cnp_grid ; 
IF NOT stop THEN 
send-hnn.grid ; 

END 

ELSE FOR ship := DESTROYER TO A-CARRIER DO BEGIN 
IF ship < CRUISER THEN 

ship-length := ship+l 
ELSE 

ship-length := ship ; 
set-position ; 
END ; 

END 1 I conputer_setup > 

PROCEDURE coin-flip ; 

VAR coin-is-heads : Boolean ; 
call_is-heads : Boolean ; 
key : Char ; 
ndnstr : StrS i 
trash, trash2 : String ; 

PROCEDURE h_or-t( its-h : Boolean ) ; 
BEGIN 

IF its-h THEN 

trash := ConcatC trash, 'Heads.' ] 

ELSE 

trash := ConcatC trash, 'Tails.' ) J 
END J < h_or-t } 

BEGIN 

draw_nsg-box C 8 ] ; 

trash := 'Lef's flip a coin to see who' 1 

nessageC trash,!] I 

trash :='starts. ' ; 

IF play-node <> 'H' THEN BEGIN 

trash ConcatC trash, 'Do you want Heads or Tails?'! 

nessageC trash, 2 1 ; 

nessageC 'Press [HI or [T]...',3 1 : 

REPEAT 

key := chrC event-key S $Sf ] ; 
UNTIL key IN t 'T', 'H' ] ; 
IF play-node = 'G' THEN BEGIN 
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ndnstr ConcatC key ) < 
out-noden( ndnstr ) i 
END i 

ELSE BEGIM . , , , . 

trash i= ConcatC trash, 'Vour opponent nakes the call. J < 
nessageC trash, 2 ) : 
REPEAT 

in_noden( ndnstr ) ; 
IF NOT stop THEN 

key := ndnstr [11 : 
UNTIL (key in I'T', "H" ]J OR stop ; 
END ; 

IF NOT stop THEN BEGIN 

call-is-heads := C key = 'H' J ; 

drau_ns9-box( 8 ) ; 

trash !=t "Vou" ) < 

IF play-node = 'H' THEN 

trash := Concatt trash, "r opponent J J 
trash i= Concatt trash, ' called ') ; 
h_or_tt call_is_heads ) ; 
nessageC trash, 1 ) ; 
trash := ' it"s ' ) 
IF play-node <> 'G' THEN BEGIN 

coin-is-heads := OddCrandCieei] ; 
IF play-node = 'H' THEN 

IF coin-is-heads THEN 

out_nodenC 'H' ) 
ELSE 

out-nodenC 'T' ) 1 

END 

ELSE BEGIN 

in-noden( ndnstr 1 ; 

coin-is-heads := ( ndnstr = 'H' ] i 
END ; 

h-or-t( coin_is-heads 1 ; 

IF play-node = 'H' THEN 

hunan-turn := ( coin-is-heads AND NOT cal 1-is-heads 1 OR 
( NOT coin-is-heads AND call-is-headsl 

ELSE 

hunan-turn := ( coin_is-heads AND cal 1-is-heads ] OR 

( NOT coin-is-heads AND NOT cal 1-is-heads) : 

IF hunan-turn THEN 

trash := ConcatC trash,' Vou 90 first.' ] 
ELSE BEGIN 

IF play-node = 'H' THEN 

trash := ConcatC trash, ' Vour opponent starts.' ] 

ELSE 

trash s= ConcatC trash,' I' '11 start first.' 1 ; 

END ) 

IF Chunan-turn AND C play-node = 'H' 11 OR 

C NOT C hunan-turn ) AND NOTC play-node = 'H' ) ) THEN 
trashZ :='But, ' 

ELSE 

trash2 := 'And' ; 
Insert C trash2, trash, 1 ! : 
nessageC trash, 2 1 ; 
pause C 12 ] ; 
END : 

END j < coin-flip > 

PROCEDURE do.hunan-turn ; 

VAR ship, ship-length, ctr : Integer ; 

ok, across : Boolean > 

k ! Integer > 

trash, trash2 : Str2SS ; 

ndnstr 1 StrS ; 

BEGIN 

draw-nsg-boxC 8 ) ; 
draw-nsg-boxC nsg-idx[8] I ! 
trash2 ;= ' ' ; 
REPEAT 

nessageC trash2, 3 ) ; 

nessageC 'Fire auay!',l 1 ; 

obj-setstateC nsg-box, nsg-idx[3], NORMAL, FALSE 1 ; 

hunan-inputC hnn-col, hnn-row, 8 ] ; 
IF NOT stop THEN BEGIN 
ok ■= cnp-gridE hnn-col, hnn-row, SHOTS ] = NOSHOT ; 
IF ok THEN BEGIN 

IF play-node <> 'C THEN BEGIN 
ndnstr := 'F' ; 
out-nodenC ndnstr ] i 
END ; 

IF cnp-grid I hnn-col, hnn-row, SHIPS ] <> NOSHIP THEN BEGIN 
cnp-gridC hnn-col, hnn-row, SHOTS ] := chrCHITl ; 
trash := 'It' 's a hit! ! ' ; 
trash2 := ' • ; 

show-synbolC 16, hnn-col, hnn-row, chrCHIT) 1 ; 
text-color C BLACK ) ; 
nessageCtrash2, 31 i 
nessageCtrash, 2) ; 

k := nanc-rankC cnp-gridC hnn-coI, hnn.row, SHIPS 1 1; 
strength! COMPUTER, k 1 := strength! COMPUTER, k ] - 1 : 
IF strength! COMPUTER, k 1 = 8 THEN BEGIN 

trash ! - ConcatC 'Vou sank ny ', ship.nane !k] ,'...' ] ; 

show-sunked ; 

nessageCtrash, 3 ) : 

strength CCOMPUTER, TOTAL] := strength ICOMPUTER, TOTAL] -1 
END ; 

END 

ELSE BEGIN 

trash2 := ' • ; 

nessage(trash2, 3) ; 

nessageC'Vour shot nisses...',2 1 > 

cnp-grid !hnn-col, hnn-row, SHOTS ] := MISS i 
END ; 

END 
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ELSE BEGIN 

trash2 := ' Vou''ve shot there already! ' ; 
obj-setstatet nsg-box, ns3-idx[3], SELECTED, FALSE ) 1 
IF cnp-gridi hnn.col, hnn_rou, SHIPS ] <> NOSHIP THEN 

shou_synbol (16, hnn_col, hnn_rou, chr CHITll ; 
text-color ( BLACK ] ; 
END : 
END i 
UNTIL ok OR stop i 
IF NOT stop THEN BEGIN 
pause ( 12 ) ; 
hunan_turn := FALSE j 
END ; 

END ; { do_hunan_turn } 

PROCEDURE do_conputer-turn ; 

UAR longest, shortest : Integer ; 

X, y : Integer ; 

done : Boolean ; 

ndnstr : StrS ! 

FUNCTION adjacent : Integer ; 
UAR ctr, col, row : Integer ; 
BEGIN 
ctr != e ; 

FOR col := x-1 TO x+1 DO 
FOR row := y-1 TO y+l DO 

IF (col >= 0 ) AND ( col <= 9 ) THEN 
IF (row >= a ) AND ( row <= 9 ) THEN 

IF ( hnn_grid[ col, row, SHOTS ] = chr(HITl) OR 
(( hnn-grid[ col, row, SHIPS ] <> NOSHIP ] AND 

( hnn_grid[ col, row, SHOTS ] <> NOSHOT ]] THEN 
ctr := ctr + 1 ; 
adjacent := ctr ; 
END ; { adjacent } 

FUNCTION untried ( xx, yy, flag : Integer ] : Integer ; 
UAR ctr, ctr2, col, row : Integer ,' 
done : Boolean ; 

BEGIN 

ctr != 1 : 

FOR ctr2 := 6 DOUNTO flag DO BEGIN 
col := X ; 
row := y ; 
REPEAT 

row := row + yy > 

col := col + XX ; 

done := (col>9] OR (row>9] OR (coKO] OR (row<Bl ; 
IF NOT done THEN BEGIN 

done := ( hnn-gridl col, row, SHOTS 1 <> NOSHOT ) 1 

IF HOT done THEN 
ctr != ctr+1 1 

END : 
UNTIL done ; 
XX := XX « (-1) ; 
yy :z yy « (-1) ; 
END ; 

untried i= ctr i 
END ; { untried > 

PROCEDURE randon_srch 1 

UAR index : Array I a..99 ] OF Integer 1 
i, ctr : Integer ; 
selective : Boolean ; 

BEGIN { randon-srch } 
selective := TRUE ; 
ctr != -1 ; 

UHILE ctr = -1 DO BEGIN 
FOR i := 8 TO 99 DO BEGIN 
X := i MOD IB : 
y := i DIU 10 ; 

IF NOT selective OR ( Odd( x + y ] = pattern ] THEN 
IF ( hnn-gridC x, y, SHOTS ] = NOSHOT 1 THEN BEGIN 
IF selective THEN BEGIN 

done := ( adjacent = 8 ) ; 
IF NOT done THEN 

done := ( rand (1881 > 98 ) ; 

END 

ELSE 

done := TRUE ; 
IF done THEN BEGIN 

IF untried( 1,8,-1 ] >= longest THEN BEGIN 

ctr != ctr + 1 ; 

index [ctr] := i ; 
END : 

IF untried( 8,1,-1 ) >= longest THEN BEGIN 
ctr := ctr + 1 ; 
indexCctr] := i i 
END 1 
END ; 
END : 
END ; 

selective := FALSE ; 
END : { while > 
i := rand( ctrtl ) ; 
i := index [i] ; 
X := i HOD 18 : 
y i= i DIU 18 ; 
END ; { randon_srch > 

PROCEDURE next-hit ; 
CONST LOOK-LEFT = 8 S 

LOOK-RIGHT = 1 ; 

LOOK-UP = 2 : 

LOOK-DOUN = 3 : 

UAR col, row, ctr, ctr2 : Integer ; 

coI2, row2, X-inc, y-inc : Integer : 
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inc. start_x!i s Integer ; 
done, reverse : Boolean ; 

PROCEDURE rand-pickC col, row : Integer ) ; 
UAR ctr, ctr2, direction : Integer ; 

srch_pattern, tenp : Array! 8.. 3 1 OF Integer ; 

BEGIN { rand-pick > 

FOR ctr := LOOK-LEFT TO LOOK-DOUN DO 

tenp [Ctrl := ctr ; 
FOR ctr := LOOK-DOUN DOUNTO LOOK-LEFT DO BEGIN 
direction := randC ctr+1 ) ! 
srch-patterni ctr 1 := tenp[ direction ] ; 
FOR ctr2 := direction TO LOOK-UP DO 
tenp[ctr2] := tenp[ctr2 + 1] ; 

END ! 

X s= col ; 
y i= row ; 
ctr := -1 ; 
REPEAT 

ctr != ctr+1 ; 

x-inc i= B J 

y-inc i= 8 ; 

CASE srch-patternt ctr I OF 
LOOK-LEFT ! X-inc 
LOOK-RIGHT : x-inc 
LOOK-UP i y-inc 
LOOK-DOUN : y-inc 
END : ( case } 
UNTIL ( untriedC X-inc, y-inc, -1 ) >= shortest ] AND 

( untriedC x-inc, y-inc, 8 ) > 1 ) ; 
X ■= X -t- X-inc ; 
y i= y -f y-inc ,' 
END ; < rand-pick } 

PROCEDURE get-next-hitC UAR c, r : Integer 1 ; 
BEGIN 

REPEAT 
REPEAT 

done := Chnn-gridC c, r, SHOTS ] = chrCHIT) ) ; 
IF NOT done THEN 
c <= c + inc ; 
UNTIL (c > 9) OR Cc < e I OR done ; 
IF NOT done THEN BEGIN 
r != r + inc ; 
c := start-xy ; 
END : 
UNTIL done ; 
END i < get-next-hit > 

BEGIN { next-hit } 
IF Odd( randCieei] THEN BEGIN 
inc s= 1 ; 
start-xy := 8 ; 

END 

ELSE BEGIN 

inc := -1 ; 

start-xy := 9 i 
END ; 

row := start-xy ; 
col := start-xy ; 
get-next-hit ( col, row ] i 
IF unresolved-hits = 1 THEN 

rand-pickC col, row ) 
ELSE BEGIN 

col2 := col-t- inc ; 

row2 := row ; 

IF (col2 > 9) OR (col2 < 8] THEN BEGIN 

col2 := start-xy ; 

row2 := row2+inc ; 
END ; 

get-next-hit ( col2, row2 1 ; 
IF col2 = col THEN BEGIN 
REPEAT 

row2 := row2 inc ; 

done := t row2 > 9 ) OR C row2 < B 1: 

reverse := done ; 

IF NOT done THEN BEGIN 

done := ( hnn-grid[ col2, row2, SHOTS 1 <> chrCHITl ) ; 
reverse := C hnn_grid[ col2, row2, SHOTS ] = MISS ) ; 
END : 
UNTIL done ; 
IF reverse THEN 
REPEAT 

row2 i= row2 - inc ; 

done != I row2 < B ] OR ( row2 > 9 ] : 
IF NOT done THEN BEGIN 

done := ( hnn-gridC col2, row2, SHOTS 1 <> chrCHIT) ) 
reverse := C hnn_grid[ col2, row2, SHOTS ] = MISS); 
END ; 
UNTIL done i 
IF reverse THEN 

rand-pickC col, row ) 
ELSE BEGIN 

X := col2 : 
y != row2 i 
END : 

END 

ELSE BEGIN 
REPEAT 

coI2 := col2 * inc ; 

done := ( col2 > 9 ) OR ( col2 < 8 ] : 

reverse != done ; 

IF NOT done THEN BEGIN 

done := C hnn-gridl col2, rDw2, SHOTS ] <> chrCHIT) } ; 

reverse := C hnn-gridC col2, rou2, SHOTS 1 = MISS ) : 
END ; 
UNTIL done ; 
IF reverse THEN 
REPEAT 

col2 := col2 - inc ; 
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END 



END 



done := ( col2 < 8 ) OR C col2 > 9 ] ; 
IF NOT done THEN BEGIN 

done := ( hnn.gridC coI2, rou2, SHOTS ] <> chrCHIT) 
reverse := C hnn.gridl coI2, row2, SHOTS] = MISS); 
END ; 
UNTIL done ; 
IF reverse THEN 

rand-pickC col, row ) 
ELSE BEGIN 

X := caI2 I 
y := row2 ; 
END ; 



END I C next-hit } 



PROCEDURE do-shot ; 

UAR ship, ship-length, ctr, col, row, x-dir, 
trash : Str255 ; 



y_dir : Integer 



Integer } : Integer 



FUNCTION wrap-aroundC a, b 
BEGIN 

IF AbsC a-b ] > 5 THEN 

urap-around := -1 
ELSE 

urap-around := 1 ; 
END ; ( urap-around } 

PROCEDURE paint-cursor C node : Integer 1 1 

VAR X, y,w, h : Integer ; 

BEGIN 

IF NOT stop THEN BEGIN 
draw-node C node ) ; 
X := 39S'>'cnp-col«24 ; 
y != cnp_row«12»rez + 24»rez + 2 ; 
w i=19 i 
IF rez = 1 THEN 

h := 9 
ELSE 

h :r 21 ; 
paint-rectCx, g,w, h} ; 
END 1 

END ; { paint-cursor } 

BEGIN { do-shot } 
paint-styleCl] 1 
Paint-Outlinet FALSE ] ; 
CASE randC3] OF 

e: trash := 'Hnnn, lef's try...' ; 
li trash := •Here''s ny shot." ; 
2: trash := 'Okay then, how about this?' ; 
END ; { case } 
nessageC trash, 1 I ; 
paint-cursorC 3 ] ; 
IF play-node = 'C THEN REPEAT 
pause ( 2 ] ; 
paint-cursor ( 3 1 ; 
x-dir := wrap-aroundC x, cnp_col ) ; 
y-dir := urap_around( y, cnp-row 1 ; 
IF (cnp-col <> x) AND (cnp_rau <> y ] THEN BEGIN 
IF OddC randClBBl } THEN BEGIN 
IF X > cnp-col THEN 

cnp-col := cnp-col * x_dir 
ELSE 

cnp-coI := cnp-coI - x-dir > 

END 

ELSE BEGIN 

IF y > cnp-row THEN 

cnp-row := cnp-rou * y-dir 
ELSE 

cnp-row := cnp-row - y-dir ; 

END : 



END 

ELSE IF X 
ELSE IF X 
ELSE IF y 
ELSE 



> cnp-coI THEN cnp-col := cnp_coI * x-dir 
< cnp-col THEN cnp-col := cnp-col - x_dir 

> cnp-row THEN cnp_rou := cnp_row + a_dir 

cnp-row != cnp_row - y-dir 



9 THEN cnp-col 
B THEN cnp-col 
9 THEN cnp-row 
8 THEN cnp-row 



IF cnp-col > 

ELSE IF cnp-col < 
ELSE IF cnp-row > 

ELSE IF cnp-row < 8 THEN cnp-row := 9 
paint-cursor( 3 ) 
UNTIL (Ccnp-col = x] AND (cnp-row = y )] OR stop 
ELSE BEGIN 
X ;= -1 ; 
REPEAT 

in-noden( ndnstr 1 ; 
paint-cursor ( 3 1 i 
IF HOT stop THEN BEGIN 

IF Length ( ndnstr ) = 2 THEN BEGIN 

cnp-col := ordC ndnstrCll ] - ordC '8' ] i 
cnp-row != ord( ndnstr [2] 3 - ordC '8' 3 ; 
IF (cnp-col < 8 3 OR ( cnp-col > 9 3 OR 
Ccnp-row < 8 3 OR ( cnp-row > 9 3 THEN 
noden-errorC 2 3 

END 

ELSE IF ndnstr = 'F' THEN BEGIN 
X := cnp-col ; 
y := cnp-row ; 

END 

ELSE 

noden-errorC 2 3 ; 
paint-Cursor ( 3 3; 
END : 

UNTIL ( X <> -1 3 OR stop i 
END ; 

IF NOT stop THEN BEGIN 

IF play-node r 'C THEN 
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pause ( 4 ) ; 

paint-cursorC 1 1 i 
draw.node (1} 1 

IF hnn-gridC x, y, SHIPS ] <> NOSHIP THEN BEGIN 
text-coIorC RED ) ; 

draw-stringC 4ee+24»cnp-col, 33»rez+12»rez»cnp_rou, chr [53 ) i 
text-color ( BLACK ] ; 

unresolwed-hits := unresolved-hits * 1 ; 
ship := nane-rankC hnn-gridC x, y, SHIPS ]) : 
strengthlHUMAN, ship] := strenythCHUMAN, ship]-l ; 
hnn-gridi x, y, SHOTS ] := chr(HIT) i 
trash •■= ■ It" "s a hit! ! " ; 
nessageCtrash, 2] ; 

IF strengthCHUMAN, ship]=8 THEN BEGIN 
shou-sunked ; 

trash != ConcatC 'Your ' , ship-nane [ship] , ' has been sunk!'] 
Message [trash, 3 ] ; 

strength [HUnAN, TOTAL] := strength [HUMAN, TOTAL] -1 ; 

trash := ship-nane[ ship ] s 
FOR col := 8 TO 9 DO 
FOR row := a TO 9 DO 

IF hnn_grid[ col, row, SHIPS ] = trashEl] THEN BEGIN 
hnn-9rid[ col, row, SHOTS ] := MISS 1 
unresolved-hits := unresolved-hits - 1 ; 
END i 

END ; 

END 

ELSE BEGIN 

hnn-9rid[ x, y, SHOTS ] := MISS ; 

trash := 'If's a niss...' 1 

nessageCtrash, 2} ; 
END : 

pause ( 12 1 1 
END ; 
END ; { do-shot } 

BEGIN < do-conputer-turn } 
drau-nsg-box ( 8 ) ; 
IF play-node = 'C THEN BEGIN 
longest := A-CARRIER i 
UHILE strengthlHUMAN, longest] = 8 DO 

longest := longest-1 ; 
shortest DESTROVER ; 
UNILE strength [HUMAN, shortest] = 8 DO 

shortest != shortest+1 ; 
IF shortest < CRUISER THEN ' 

shortest := shortest-^l ; 
IF longest < CRUISER THEN 
longest := longest * 1 ; 

IF unresolved-hits <> 8 THEN 

next-hit 
ELSE 

randon-srch > 

END ; 

IF NOT stop THEN BEGIN 
do-shot ; 
IF NOT stop THEN 

hunan-turn := TRUE ; 

END ; 

END ; { do_conputer-turn > 
PROCEDURE show-conputer-setup j 

VAR k, x,y : Integer : ' 
BEGIN 

FOR x := 8 TO 9 DO 
FOR y := 8 TO 9 DO 

IF cnp-grid[ x, y, SHIPS ] <> NOSHIP THEN 

IF cnp-grid[ x, y, SHOTS ] <> chr[HIT) THEN 

show-synbolC 16, x, y, cnp-grid[ x, y, SHIPS] ) ; 
text-styleC NORMAL ) ; 
END i { shou-conputer-setup } 

PROCEDURE play-gane ; 
UAR key : Char ; 

nsgl, nsg2 : Str255 ; 

BEGIN 

rez := getrez ; 

IF rez = 8 THEN BEGIN 

nsgl := ' [3] [ (Battle Blips nust run inl' 1 

nsgl := ConcatC nsgl, 'nediun or high resolution.! ] [Sorry!]' ] . 
rez := do-alertC nsgl, 1 ] i 

END 

ELSE BEGIN 
do-open ; 

IF NOT stop THEN BEGIN 
REPEAT 

init-grids ; 
setup-screen I 
IF cont-gane THEN 

uait-opponent 
ELSE BEGIN 

hunan-setup ; 
IF NOT stop THEN BEGIN 
wait-opponent ; 
IF NOT stop THEN BEGIN 
conputer-setup i 
IF NOT stop THEN 
coin-flip I 

END ; 
END : 
END : 



IF NOT stop THEN 
cont-gane := TRUE 

REPEAT 

IF NOT stop THEN 
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IF hunan-turn THEN 

do-hunan_turn 
ELSE 

do_conputer_turn ; 
UHTIL ( strength [ COHPUTER, TOTAL ] = B ] OR 
( strength [ HUMAN, TOTAL ] r 8 } OR 
stop ; 

IF HOT stop THEN BEGIN 
cont-gane := FALSE ; 
drau_nsg_box ( 6 ) ; 

IF strength [COMPUTER, TOTAL] = B THEN BEGIN 
nsgl := 'Congratulations! Vou win!!' i 
nsg2 := ' ■ ; 

END 

ELSE BEGIN 

nsgl := 'Sorry, you lose..,' ; 

nsg2 ;= ■Here"s the rest of ny fleet." ; 

show_conputer_setup ; 
EHD ; 

nessageC nsgl, 1 ] ; 
Message ( nsg2, 2 1 s 

HHILE event-key <> -1 DO ; {clear keypresses} 
IF play-node = 'C THEN BEGIN 

nessageCCare to play again? tV/Hi'.Z ) ; 

REPEAT 

key ;= chr( event-key S $5f ] ; 
UHTIL keg IN fV, 'N', chrt CR J ]; 

END 

ELSE BEGIN 

nessageCPress any key to exit... ',3 ) j 
HHILE event-keg = -1 00 ; Cwait for a keypress} 
key :='»•! 
EHD ; 
EHD ; 

UHTIL Ckey <> 'Vl OR stop i 
EHD ) 
do-closc ; 
END I 
END; I play-gane } 

PROCEDURE initialize ; 
VAR junk : Integer i 
trash i Str2SS ; 

BEGIN 

ship-nanetl] := 'Destroyer' j 

ship-nane[2] := 'Subnarine' ; 

ship-nane[3] := 'Cruiser' ; 

ship_nane[4] := 'Battleship' ; 

ship-naneCSl := 'Aircraft Carrier' ; 
title i= ' Battle Blips! ' i 



nsg-box := new-dialog( 8, 28,19,48,5 ] : 

nsg_idx[8] := add-diten (nsg.box, g_text, none, 1, 4, 38, 1, 8, 258 J ; 
FOR junk := 1 TO 3 DO 

nsg-idx[junk] :=add-diten Cns9_box, g_boxtext, none, 1, junk, 38, 1, 8, 256 ] ; 

trash != ConcatC chr(4J, ' ',chr(3J,' ',chrtll,' ',chrC2) ) ; 
trash := ConcatC trash, ' [RETURN] [UNDO]' J i 
set-dtext( nsg-box, nsg_idx[8], trash, 5, TE_CENTER 3 ; 
cont-gane := FALSE ; 
END ; { initialize } 

(» _ ,j 

(« To create a desk accessory, nodify the following BEGIH-END «) 

(» block of code so that it will conpile and nodify the next •] 

(« BEGIH-END block of code so that it won't conpile. «] 

l» Make sure the first progran line: «) 

(» {$At,D-, S18 } «] 

(* is NOT connented out. «] 

(» ,j 

BEGIN { Battle-Blips ( accessory } } 
ap-id := Init-Gen ; 
IF ap-id }= 8 THEN BEGIN 

dunny := Nenu-Register ( ap-id, title I ; 

initialize 1 

UHILE TRUE DO BEGIN 

dunny := get_event CE-Message, 0, 8, 8, 8, 

FALSE, 8, 8, 8, 8, FALSE, 8, 8, 8, 8, 
nsg, dunny, dunny, dunny, dunny, dunny, dunny ] ; 
IF nsg [8] = AC-OPEN THEN 
plag_gane ; 

EHD : { while } 
EHD ; 

C» 

t» To create a standalone application, nodify the following BEGIN-END ») 
(» block of code so that it will conpile and nodify the previous «) 
(» BEGIN-END block of code so that it won't conpile. «) 
(» Make sure the first progran line: «) 
(» {$At, D-, Sie } K) 
(» IS connented out. w] 
t, *] 

(*• 

BEGIN { Battle-Blips ( progran ) } 
ap-id := Init-Gen ; 
IF ap-id >= 8 THEN BEGIN 

initialize ; 

play_gane I 

exit-gen ; 
END ; 

«») 

END, ( Battle-Blips } 
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One of the hardest things about 
programming the ST Is just figuring out 
what everything means. You come across 
cryptic terms hke "message pipes, ' "ob- 
ject trees," "memory fonn definition 
blocks". . . yikes! What are these things? 
Who can you turn to for help? This is not 
my beautiful house! This is not my beau- 
tiful wife! (Apologies to the Talking 
Heads.) 

In this article, I'm going to take a close 
look at a couple of the reference books 
available to the would-be ST programmer 
who doesn't want to cough up $300 for 
the Atari Developer's Kit. I've used Just 
about all of the popular ones myself (in- 
cluding the Developer's Kit), and unfor- 
tunately every one of them contains 
numerous mistakes. I'll provide a listing 
of some of the errors I've encountered in 
my own programming exploits, and 
hopefully spare one or two of you the 
woes I've had to go through. (Sob! Boo- 
hoo! . . . SLAP! Thanks— I needed that.) 

By now, everyone knows that Abacus 
has cornered the market on reference 
books for the ST. At last count, they had 
no less than 12 titles, covering everything 
from beginner's Logo and ST Basic to 3D 



graphics in assembly language. Most of 
the Abacus books do a very decent job of 
covering their subjects and are fairly well 
organized, although some lack indexes 
and other niceties. One has to wonder, 
though, if Abacus employs a proofreader 
at all . . . many of their books are inexcus- 
ably full of typos, misspellings, and just 
plain bad English. Of course, some of 
them are translated from German, which 
probably accounts for the contorted 
phrasing; but at times, reading an Aba- 
cus book is somewhat akin to reading 
Lewis Carroll's Through the Looking 
Glass. 

For the programmer, two of these 
books are essential: ST Internals and the 
GEM Programmer's Reference. These two 
books contain most (certainly not all) of 
the information you'll need to program 
the ST; in fact, if you don't want to use 
GEM (i.e. no dialog boxes, drop-down me- 
nus, or any of that stuff), ST Internals will 
do quite nicely by itself. Actually, I have 
to admit I'm surprised that Abacus got 
permission to print the section on the 
Line A graphics primitives at all — the 
Line A document in the Atari Developer's 
Kit is marked "Confidential!" on each and 
every page! 

Unfortunately, as valuable as ST Inter- 
nals is, the typo monster ran amok in 
this book. There are so many mistakes 
that I'm not even going to try to list them 
all. Watch out for the function numbers 
they use in the examples for the GEMDOS 
calls; sometimes they're wrong, even 
though the descriptions use the right 
numbers. Another common error in 
Internals shows up in a lot of the GEM- 
DOS examples in assembly language. 
GEMDOS is called from assembly lan- 
guage by pushing parameters on the 
stack, doing a TRAP #1 (the 68000's 
TRAP instruction causes a branch 
through a vector contained in low 
memory; there are 16 possible TRAP vec- 
tors), and then correcting the stack 
pointer. In many of the examples In In- 
ternals, they add the wrong value to the 
stack pointer to correct it. This can lead 
to big trouble, and it can be very hard to 
find this kind of error in a large program; 
so if you use the examples in Internals 
as guides for your own routines be sure 
to double-check your stack corrections. 

Since this article was first written. Aba- 
cus has released two subsequent editions 
of ST Internals. The second edition fixed 
some but not all of the most glaring er- 
rors. The recently-released "Third Revi- 
sion" is a substantial improvement over 
its predecessors, although many errors 
and typos still remain. This edition con- 



tains quite a bit of new material, includ- 
ing information about GEMDOS memory 
management and the blitter chip, and a 
commented disassembly of the first part 
of the ST's ROM. Many more assembly 
language examples are given as well. If 
you're considering buying ST Internals, 
by all means try to make sure you get the 
third revision. If, however, you already 
own a copy of the first or second edition, 
you may find the error list provided be- 
low invaluable. 

Some of the worst mistakes in the first 
and second editions of ST Internals: 

Pg. 105— The second line of the example 
for the TERM function should read 
"TRAP #1." They left out the "#1." 
Pg. 110— The description of the SETDRV 
function (# $0E) is misleading. It reads, 
"The current drive can be determined 
with the function SETDRV." It should 
say, "The current drive can be set . . . . " 
Also, the last sentence in the description 
is wrong. It should say, "After the call, DO 
contains a bit map of the active drives." 
Pg. 113— In the example for the SUPER 
caU (# $20) the fourth instruction is given 
as "ADD.L $6,SP." This should be "ADD.L 
#6,SP." 

Pg. 114— The wrong value is added to the 
stack in the example for SET DATE, func- 
tion number $2B. That "ADDQ.L #6,SP" 
should be "ADDQ.L #4,SP." 
Pg. 115— The same mistake is made in 
the example for the SET TIME fljnction. 
Pg. 120— In the third paragraph of the 
description of the CREATE function, the 
second sentence contains a typo. It 
should read, "Attribute $04 creates a 'hid- 
den' file and attribute $02 a 'hidden sys- 
tem' file." 

Pg. 122— In the example for the OPEN 
function, the second line of code should 
read, "MOVE.L #filename,— (SP)." 
Pg. 124— The wrong function number is 
used in the example for READ— function 
number $3F. The example Incorrectly 
uses $3E. 

Pg. 125— In the example for UNLINK 
(function $41) there's a "#" sign missing 
from in front of the label "pathname." 
The first line of code in the example 
should read "MOVE.L #pathname,— (SP)." 
Pg. 130— In the second example for the 
MALLOC function (# $48), the fifth line 
of code is wrong. It says, "TST.W DO." It 
should read, "TST.L DO." 
Pg. 133— Some important information is 
missing from the description of the EXEC 
call (# $4B). The mode word can be 0, 3, 
4, or 5, not simply 0 or 3 as Abacus states. 
Here are the functions of each mode: 
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0 = Load a program and immediately 
start. 

3 = Load a program witliout executing. 
The address of tlie program's basepage (or 
an error message) is returned in DO. 

4 = Execute program loaded with 
mode 3. Pass zeroes for the environment 
and iilename, and pass the address of the 
basepage (returned from mode 3) as the 
command line. 

5 = Create a basepage. 

Also on page 133, the wrong value is ad- 
ded to the stack in the example. "ADD.L 
#14,SP" should be "ADD.L #16,SP," 
Pg. 135— In the paragraph dealing with 
the 44-byte DTA buffer, bytes 26 through 
29 are described as the "File size in bytes 
(low byte, high byte)." This is incorrect; 
the file size is in standard Motorola for- 
mat, high bj^e to low byte. Also on page 
135, the example given for the SFIRST 
call is very confusing. Here's how it 
should appear: 

(SEE TABLE 2) 

Pg. 160— The top line of this page should 
read: 

3 logbase get logical screen base 
Pg. 162— Another wrong value added to 
the stack! This time it's in the example 
for the XBIOS setscreen function (# 5). 
In both examples, the "ADD.L #10,SP" 
should be "ADD.L #12,SP". 
Pg. 165— In the description of the XBIOS 
f loprd function the possible sector nimi- 
bers are listed as 0-9. They should be 1-9. 
(Do you think the person who wrote that 
ever actually used this function?) 
Pg. 176— The description of the XBIOS 
keytbl function is rather garbled. To get 
the address of a table containing the three 
keyboard table pointers, pass —1 for all 
three parameters. 

Pgs. 192,193— The descriptions of the 
offgibit (- 29) and ongibit (- 30) func- 
tions are reversed. Also, the descriptions 
say to pass the number of the bit you 
want to change— wrong; you pass a word 
value that will be ANDed or ORed with the 
register. 

Pg. 203— In the assembly examples for 
the wvbl function (wait for vertical 
blank), the wrong function number is 
used. It should be 37, not 36. 
Pg. 223— The description of the Line A 
TRANSFORM MOUSE opcode is missing 
some important data. The book says 34 
words are necessary to define the new 
mouse form; actually, 37 words are neces- 
sary. Add these three lines to the begin- 
ning of their list of parameters; 

INTIN(0) Hot spot X position. (0-15). 

INTIN(l) Hot spot Y position. (0-15). 

July 1988 ST-Leg 



INTIN(2) Number of color planes. 
Pg. 224— In the description of the Line A 
DRAW SPRITE opcode, word 3 (the for- 
mat flag) is given incorrectly. The book 
says "0 = VDI format, 1 = XOR format"; it 
should be "0 or 1 = VDI format, -1 = XOR 
format." Actually, I think any positive 
number denotes VDI, and any negative 
number denotes XOR. 
Pg. 249— Location $44C is described as a 
word value (two bytes). This location con- 
tains the current screen resolution 
(0 = low, 1 = medium, 2 = high) and is a 
byte value, not a word. 
Pg. 251— At the top of the page, the sys- 
tem variable swv vee at location $46E 

is described incorrectly. The book says, 
"A branch is made via. this vector with 
the screen resolution is changed." That 
"with" should be "when." Also, the book 
doesn't say that this vector is only used 
if you change from a monochrome to a 
color monitor, or vice versa. The vector 
is not used when you switch between 
medium and low resolutions. 
Pg. 251— The default value for location 
$484 is Incorrect. It should be 7 not 6. 
Pg. 253— The default value for location 
$4BA (the 200IIZ timer) is given as 
$71280. This isn't strictly wrong; but it 
is kind of ridiculous, since location $4BA 
is incremented every 200th of a second. 
The Abacus "default value" is Just what 
happened to be there at the instant they 
looked. 

This error listing probably doesn't 
cover all of the mistakes in ST Internals-, 
but it should give you an idea of the kinds 
of things to watch out for if you're using 
this book. 

Another problem with the Abacus ST 
Internals book is that the names given for 
the GEMDOS function calls are all differ- 
ent from the names listed in the bindings 
for both Alcyon and Megamax C. This 
isn't really an error; after all, it doesn't 
matter what names you use for the func- 
tions. However, if you're programming in 
C it can be hard to find the proper 
descriptions since Abacus and your C 
manual will disagree on the function 
names. The chart in Figure 1 lists each 
GEMDOS ftmctlon with both its "Abacus" 
and its "legal" name ("legal" meaning the 
name given to it in the C bindings). 

The GEM Programmer's Reference con- 
tains fewer errors than ST Internals. The 
worst error (one that caused me tons of 
frustration during a recent programming 
project) is lurking in their examples for 
application initialization in assembly lan- 
guage (not in the C example). The initiali- 
zation examples are found in three places 
in the Programmer's Reference; pages 
50-53, 249-254, and 271-272. In all three 



examples, they fail to save and use the 
proper value for the VDI handle. GEM in- 
itialization is achieved by several 
steps:appl_init. followed by 
graf_handle, followed by 
v_opnvwk. The graf_handle call 
returns a value that is passed to the 

V opnvwk call; then v_opnvwk 

returns a value of its own, which should 
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An integrated programming environ- 
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prototype small applications which 
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GEMDOS Function Names. 



Abacus 




Kin 


MUaCUa 


r 


No 


TERM 


PtermO 


$00 


KEEP PROCESS 


Ptermres 


$31 


CONIN 


Cconin 


$01 


DISK FREE SPACE 


Dfree 


$36 


CONOUT 


Cconout 


$02 


MKDIR 


Dcreate 


$39 


AUX INPUT 


Cauxln 


$03 


RMDIR 


Ddelete 


$3A 


AUX OUTPUT 


Cauxout 


$04 


CIIDIR 


Dsetpath 


$3B 


PRINTER OUTPUT 


Cpmout 


$05 


CREATE 


Fcreate 


$3C 


RAWCONIO 


Crawio 


$06 


OPEN 


Fopen 


$3D 


DIR CONIN W/0 ECHO 


Crawcin 


$07 


CLOSE 


Fclose 


$3E 


CONIN W/0 ECHO 


Cnecin 


$08 


READ 


Fread 


$3F 


PRINT LINE 


Cconws 


$09 


WRITE 


Fwrlte 


$40 


READLINE 


Cconrs 


$0A 


UNLINK 


Fdelete 


$41 


CONSTAT 


Cconis 


$0B 


LSEEK 


Fseek 


$42 


SETDRV 


Dsetdrv 


$0E 


CHANGE MODE 


Fattrib 


$43 


CONOUT STAT 


Cconos 


$10 


DUP 


Fdup 


$45 


PRTOUT STAT 


Cprnos 


$11 


FORCE 


Fforce 


$46 


AUXIN STAT 


Catixis 


$12 


GETDIR 


Dgetpath 


$47 


AUXOUT STAT 


Cauxos 


$13 


MALLOC 


Malloc 


$48 


CURRENT DISK 


Dgetdrv 


$19 


MFREE 


Mfree 


$49 


SET DTA ADDRESS 


Fsetdta 


$1A 


SETBLOCK 


Mshrlnk 


$4A 


SUPER 


Super 


$20 


EXEC 


Pexec 


$4B 


GET DATE 


Tgetdate 


$2A 


TERM 


Pterm 


$4C 


SET DATE 


Tsetdate 


$2B 


SFIRST 


Fsfirst 


$4E 


GET TIME 


Tgettime 


$2C 


SNEXT 


Fsnext 


$4F 


SET TIME 


Tsettime 


$2D 


RENAME 


Frename 


$56 


GET DTA 


Fgetdta 


$2F 


GSDTOF 


Fdatime 


$57 


GET VERSION NUMBER 


Sversion 


$30 









FIGURE 1 



be used as the "handle" number for all 
VDI function calls. In the Programmer's 
Reference, they use the value returned by 
graf handle as the VDI han- 
dle . . . .this is wrong, wrong, wrong! Af- 
ter the V opnvwk call, the real VDI 

handle Is returned in the application's 
control array, in control[6]. Using the 

value from graf handle can lead to 

all kinds of impossible-to-track-down 
bugs. In the case of my program, it ran 
fine without a single problem but 
caused mucho havoc with other pro- 
grams after I exited. After running my 
program, some other programs would 
come up without a mouse cursor, and 
if I called accessories from the desktop 
they would not be erased from the 
screen when 1 closed them. 

1 suspect that a lot of the programs 
that have a reputation for causing trou- 
ble with other programs are using the 
wrong VDI handle value, and hopeless- 
ly confusing the poor ST! If you're 
programming in assembly language, al- 
ways be sure to save the vahie that the 
VDI returns to you in control[6] af- 
ter the V opnvwk call, and pass it as 



the handle when you call any other 
VDI functions. A note of interest— in 
the C examples in the Abacus books, 
the VDI handle is always obtained cor- 
rectly. In the C statement: 

V opnvwk (work in, &;handle, 

work_out); 

the ampersand symbol in front of the 
variable "handle" indicates that a value 
is returned in that variable. The C bind- 
ings for the V opnvwk call take care 

of getting the proper VDI handle from 
your program's control array for you. 

On page 199 of the Programmer's 
Reference, there is an error in the 

description of the VDI vq mouse 

call. After the call, intout[0] will con- 
tain the status of the mouse buttons 
(not "button," as Abacus says). Bit 0 in- 
dicates the left button status, bit 1 the 
right; if the bit is on, that button is be- 
ing pressed. Therefore, the possible 
button values returned from 
vq mouse are: 

0 = No buttons pressed 

1 = Left button 

2 = Right button 

3 = Both buttons 



When you click on a window to acti- 
vate it ("top" it) or when you call an ac- 
cessory from the 'Desk' drop-down 
menu, GEM lets the chosen application 
know of your desires by sending a 
"message" to it. The programmer sets 
aside a small buffer that serves as the 
"message pipe," the place where GEM 
will write these messages as they occur. 
(See, message pipes aren't all that mys- 
terious, are they?) The first word (two 
bytes) in the message pipe is always the 
message identifier, and each message 
has a unique identifier. In the GEM 
Programmer's Reference, the message 
events are described on pages 308 
through 311— and here we find some 
more errors. 

Pg. 309— the WM_FULLED message 
is missing its description. This message 
indicates that the user has clicked on 
a window's "full box" (in the upper 
right-hand comer) to enlarge the win- 
dow to full screen size. When a 
WM_FULLED message occurs, word 0 
of the message pipe will contain 23, 
and word 3 will contain the window 
handle of the chosen window. 
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Pg. 311— several mistakes rear their 
ugly heads. The information for the 
WM_NEWTOP, AC_OPEN, and 

AC CLOSE messages is all wrong. 

Here's how they should appear: 

WM_NEWTOP: 

The application is informed that a win- 
dow was activated. 

Word 0 = 29 (Abacus says 30. . .) 
Word 3 = Window handle (They got 
this one right!) 

AC_OPEN: 

The user selected one of the six desk 
accessories. 

Word 0 = 40 (Abacus says 
30. . .again.) 

Word 4 = The menu Identification 
number, which can be read through 
the function MENU_REG1STER. (Aba- 
cus says this value is in word 3.) 



AC_CL0SE: 

This event occurs under the following 

conditions: 
The screen is cleared. 
The window data has changed. 
The running application was 



interrupted. 

Word 0 = 41 (Abacus says 31. . .) 
Word 4 = Menu ID number (see also 
AC_OPEN) 

Sadly, the wrong info for the 
AC_OPEN and AC_CLOSE messages 
is repeated throughout every source of 
documentation for the ST (including 
the Developer's KitI). This little tidbit 
caused me a few days of grief while 1 
was developing my Font Tricks acces- 
sory (from ST-LOG #10), since when an 
accessory isn't active it just sits and waits 

for the AC OPEN message. If you follow 

the docs, you'U be watching for a message 
that never comes. Font Tricks was writ- 
ten in assembly language; once again, if 
you program in C and use the standard 
files for equates, you'll never run into this 
problem . . . 

because the C bindings have these mes- 
sages listed correctly! In fact, that's how 
I eventually found out the truth about the 
message numbers— by looking through 
the C equate files in the Developer's Kit. 

On page 322 in the description of the 
AES appl_write call, the parameters 
for the control array are given incorrect- 
ly. The input parameters should be: 

control(O) = 12 

control(l) = 2 

control(2) = 1 

control(3) = 1 

controI(4) = 0 



Corrected SFIRST call 



MOVE.L 


#dta,-(8P) 


•Set up DTA buffer 


MOVE.W 


#$1A,-(8P) 


•Function number SETDTA 


TRAP 


#1 




ADDQ.L 


#6,SP 




MOVE.W 


attrib,-{8P) 


•Attribute value 


MOVE.L 


#flInam,-(8P) 


•Name of file to search for 


MOVE.W 


#$4E,-(SP) 


•Function number 


TRAP 


#1 




ADDQ.L 


#8,SP 




TST 


DO 


• File found? 


BNE 


notfound 


•Apparently not 


attrib: 








.dew 0 


•Search for normal flies only 


flinam: 






.dc.b '•.•',0 


•Search for 1st possible file 


dta: 








.ds.b 44 


•Space for the DTA buffer 



There are quite a lot of AES functions 
missing from the Programmer's Refer- 
ence. For example, there is no mention 
at all of the fsel_input call . . . odd, be- 
cause this is one of the most handy and 
easy-to-use functions In the AES 
Libraries. This is the call which puts the 
'Item Selector' dialog box on the screen, 
allowing you to select files from disk for 
saving, loading, etc. 

To close this tale of heartache and woe, 
here's a description of the syntax for the 
fsel_input call (just for the heck of it, 
in the Abacus style), for those of you 
without any docs on it: 
F8EU_INPUT: Opcode = 90 

FUNCTION 

Display the GEM FUe Selector Dialog Box. 



Input: 
control(O) 
control(l) 
control(2) 
control(3) 
control(4) 



90 

0 

2 

2 

0 



addrin(O) = dir spec 

addrin(l) = file sel 

Output: 

intout(0) = ret code 

intout(l) = exit ^but 



dir — spec: Pointer to a string that 
describes the original directory specifica- 
tion. On exit, this points at the directory 
selected by the user. 

file sel: Pointer to a string that contains 

the filename selected by the user. 

ret code: If zero, an error occurred. If 

greater than zero, everything's fine. 

exit but: Indicates which exit button 

was selected. 0 = Cancel, 1 = OK. 



Charles F. Johnson is a professional mu- 
sician, and now semi-professional com- 
puter programmer/reviewer/author. He 
lives in Los Angeles with his wife Patty 
and Spike, the world's most intelligent 
(and gluttonous) cat. Charles is a sysop on 
the Analog and ST-LOO Atari SIG on Del- 
phi; his user name is CFJ. 
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DATABASE 

DELPHI 



If you take a peek out your window, 
you'll see that summer Is heating up. 
Likewise, things are heating up on Del- 
phi. By now, the much requested sepa- 
ration of the Atari camps into two SIGs 
should have taken place. At the time of 
this writing (early April), the work was 
nearly completed to move ST files into 
that area and get the road paved for the 
smooth transition. The housekeeping 
Includes such chores as selecting topic 
names for Forum and Database entries, 
and getting the shopping area "built" 
for those individuals and companies in- 
terested in selling their wares on Del- 
phi. This is one of the less discussed 
aspects of the network, and we'll touch 
on it in a future Database Delphi 
installment. 

Also up in the air at the time of this 
writing was the actual name of the SIG. 
The plan was to keep the title (as it wUl 
appear on the Groups menu) unique, so 



by Andy Eddy 

users can type Just a couple of letters 
to enter the desired SIG (such as typ- 
ing AT to get to the ANALOG/Atari SIG 
previously). Unfortunately, the name 
couldn't begin with the obvious choice 
of "ST," or there would be a conflict 
with the Starship Commodore SIG; 
similarly, using "AT" for Atari or "AN" 
for ANALOG would conflict with the ex- 
isting 8-bit SIG. There's nothing more 
annoying than getting "The term 'ST' 
defines more than one command," Del- 
phi's reply to menu collisions like the 
ones just noted would cause. 

By the time you sit in your sun- 
drenched lawn chair to read this— if 
you're not already prone, please do so 
now— the issue will have been resolved 
and you'll have found your way to our 
new home. Just the same, we'll note it 
in the next Database Delphi. No matter 
what the outcome, the staff overseeing 
the data flow will continue to be the 



same cheery lot as before. 

A Glance Askance 

The forum has also been warming to 
a variety of subjects lately— some good, 
some potentially bad. Talk of WordPer- 
fect dropping ST support (which was 
later vehemently denied by the compa- 
ny), mention of a new product called 
Turbo-ST (an interesting piece of soft- 
ware that claims to act like a text Wit- 
ter, speeding moves of characters on- 
screen) and the potential of bringing up 
a matching desktop configuration 
when changing resolutions, were 
among the loft;ier subjects of discus- 
sion. The latter was bandied back and 
forth between some of the program- 
ming gurus online, namely Lloyd Pul- 
ley (MADMODIFIER, author of the pub- 
lic domain, multipurpose boot program 
called Megamatic), Darek Mihocka 
(DAREKM, author of the ST Xformer, 
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8-bit emulator) and our own Charles F. 
Johnson (CFJ). Apparently there is a so- 
lution to this dilemma, but you'll have 
to wait to see it for yourself, as Charles 
is planning on gracing ST-Log readers 
with his fix. For now, mum's the word. 

As far as the other topics I men- 
tioned, they are more related than they 
appear. If I may stand on the soapbox 
for a second, most everyone is suffi- 
ciently concerned by the stigma that 
piracy has placed on the ST market. 
The rumor spread that WordPerfect 
would drop the ST as a market due to 
the discovery of some BBSs carrying 
the word processor in their libraries; 
but of course WordPerfect isn't alone 
in their concern. Many other de- 
velopers, big and small alike, are get- 
ting scared off. 

If you look at the other side of the 
coin, smaller scale developers like 
Wayne Buckholdt of Softrek, the mak- 
ers of Turbo-ST, show the exciting, 
barely tapped potential of the ST. Only 
if enough people buy the products— as 
opposed to stealing them— will our 
favorite computer continue to flourish. 
Furthermore, if piracy continues un- 
abated, it lessens the ability for the 
manufacturers to support the brand 
lucratively. 

The bottom line— and we've said it 
before— is to discourage piracy in all 
forms. It's illegal to possess a program 
that you haven't paid for, yet it's very 
difficult for anyone to do anything 
about it. It requires a certain amount 
of consumer responsibility. If you own 
pirate software, either destroy it or pay 
for it; if you know of someone dealing 
pirated products, tell them you don't 
appreciate what they are doing; if you 
know of a pirate BBS, contact the Soft- 
ware Publishers Association (Suite 
1200, 1111 19th Street, N.W., Washing- 
ton, D.C. 20036) and/or the manufac- 
turers whose products appear on the 
board. Software for Atari computers 
has always been reasonably priced, so 
there's no reason to take it. You'll do 
us all a favor. End of sermon. Please be 
seated. 

Ready, Set . . . SET! 

In the brief space we have left, we can 
look over how to best wangle our way 
through the materials we have at hand 
on Delphi: SETTINGS. 

At the ANALOG > prompt (or any SIG 
prompt for that matter), type SET. It 
works like this: 



ANALOG > What do you want to do? 
set Preferences Menu: 

Name Change 
Editor Preference 
Topic Selection 
Settings (Profile) 
HELP 
Exit 

All the stuff here Is reasonably self- 
explanatory, though we'll go in depth 
on the editors at a later date, as there 
is too much to cover in a short glimpse. 

The power selection here is Settings, 
and if you enter SET again, this time 
from the PREFERENCES > prompt, 
you'll get the following: 

PREFERENCES > 
(Name,Edit,Top,Set,Help,Exit) set 
Some of your temporary settings are 
being restored to their initialization 
values. 

SETTINGS >? 

SETTINGS Menu: 



BUSY-Mode 

DEFAULT-Menu 

DOWNLOAD-Llne- 

termlnators 
ECIIO-Mode 
EDITOR 

FILE-TRANSFERS 
KERMIT-SETTINGS 
LENGTH (Lines/page) 
NETWORK- 
PARAMETERS 
PASSWORD (Change) 



PROMPT-Mode 

SET-IIlgh-bit 

SLASII-Term-settlngs 

TERMINAL-Type 

TIMEOUT 

UTILITIES 

WIDTH (Columns) 

XMODEM-SETTINGS 

HELP 

EXIT 



Again, the entries are descriptive 
enough in most cases to get you by. 
Simply put, you can tailor your charac- 
teristics to whatever you desire. Would 
you like to do file transfers in Ymo- 
dem? Go to the XMODEM-SETTING 
menu. Would you like to limit the time 
that you can stay idle and remain on- 
line? Simply go to the TIMEOUT area 
and set a value. That way, if you are 
called away in a hurry and don't log off, 
Delphi will automatically terminate the 
session in that amount of time. As a 
warning that the time-out figure is 
coming nigh, you'll get the message, 
"Please respond within 30 seconds to 
avoid being automatically logged off," 
Just in case you were asleep at the 
wheel and still want to stick around. 

Perhaps the most powerful feature 
from the Settings area is the DEFAULT- 
menu selection. Here you can enter 
what you want Delphi to do for you 



when you first log on. For example, my 
Default menu is GRO AT WHO (short 
for GROUPS ATARI WHO). When the 
initial log-in procedure is completed by 
Delphi, it reads the GRO AT WHO as if 
it was typed in. Saving me the trouble, 
it runs me past the GROUPS AND 
CLUBS area, to the ANALOG/Atari SIG 
and then gives me a listing of who is 
online in the ANALOG Atari SIG at the 
time. 

It's important to note that some of 
these selections are not for the layman 
telecommunicator. And keep in mind 
that if you frequent different SIGs, 
you'll need to set up some SETTINGS 
from area to area. Just the same, with 
a bit of playing, you can find out what 
most of the other functions do and can 
best put them to your benefit. 

Book Him, Mike. . . 

I've also just picked up a copy of 
Michael Banks' (Database Delphi 
columnist for ANALOG Computing) 
book, Delphi: The Official Guide, a Bra- 
dy Book, which is published by Pren- 
tice Hall Press. I realize that informing 
you of this may ultimately put me out 
of a job, due to the fact that this book 
covers everything I might want to talk 
about here. A 500-page handbook, Del- 
phi: The Official Guide, is a great refer- 
ence tome that details all you'd ever 
want to know about Delphi. It's only 
$19.95, and will easily save you that 
much in online costs. If you want to 
save some time in picking up a copy, 
you can order online by typing GO 
GUIDE. 

In association with Delphi, ANALOG 
is able to offer a sign-up that can put 
the guide in your hands and get you a 
regular account on Delphi at the same 
time, provided you aren't already a 
member. This reduced price offer- 
available after May 1st— not only gives 
you a lifetime membership to Delphi (a 
$19.95 value), but also a copy of Delphi: 
The Official Guide and a free hour of 
online time at non-prime rates. If you 
log into Delphi employing username 
JOINDELPHI and password ANALOG, 
you'll be brought up to this signup 
offer. 

Finally, don't forget that we meet ev- 
ery Tuesday night in the Conference 
area, at 10 p.m. Eastern time. This will 
continue to be the date after the new 
ST SIG has started up. Turnout has 
been increasing and conversations 
cover all topics, so stop by and chat 
with us. 

Till next month, C U onUne .... 
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MORE SUPERIOR PRODUCTS FROM NAVARONE 




ST VIDEO 
DIGITIZER 




Digitize from any standard com- 
posite video source (e.g. VCR, 

video camera, etc.). Save digitized pictures into NEO or DEGAS™ file formats. 
This is the fastest digitizer available for the ST. Capture single frames in less than 
a second. Excellent for student, hobbyist, or to put pictures in your desktop pub- 
lishing projects. The picture above was taken with the ST Video Digitizer and 
printed directly on a laser printer. 



ST SOUND DIGITIZER 

Digitize real-world sounds from microphone, record player, ^1 ^M '*^^ 
tape recorder, guitar, etc. Play back through your amplifier 
or MIDI keyboard. The ST Sound Digitizer can be used to 

create music, experiment with sounds, edit short commercials, or use for voice mail. 
Very easy to use software provides powerful editing and mixing features. 



TIMEKEEPER 



This is our popular clock calendar plug-in cartridge. The $ 
Timekeeper comes complete with removable long life lithium 
battery ready to use. Just plug it into the cartridge slot and 
set up either an Auto folder or Accessory program to automatically set Time and 
Date each time you turn on your ST. 
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.95 



To Order: Call our toll free number or send M.O. plus shipping (call for rates). 
VISA, MC, C.O.D. welcome. California residents add 7% sales tax. 
NAVARONE 

1-800-624-6545 (Nationwide) 
Or (408) 378-81 77 (California) 

NAVARONE INDUSTRIES, INC. • 454 Kenneth Avenue • Campbell, CA 95008 




Prices and availability are subject to change without prior notice, DEGAS is a registered trademark of Batteries Included. Inc- 
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Step 1- Hard Facts 



More 
Baudy T^les 

Using a modem. 

by Maurice Molyneaux 

Back in the April '87 issue of ST-Log ap- 
peared my article "A Baudy Tale," which 
was a beginner's guide to telecommuni- 
cations. In that article I discussed what 
a modem is, various aspects of how they 
work, terminology, etc. If you haven't 
read that article before, it might be a good 
idea to read it now (if you have the issue). 
In this installment of Step I we're going 
to discuss not the subject of modem hard- 
ware, etc., but of using a modem and ter- 
minal software. 

Before going on, I would like to thank 
Supra Corp. for providing me with their 
Supra 2400 baud modem for use in the 
writing of this article. Four different mod- 
ems were used to research this article: 
the Hayes Smartmodem 1200, Atari 



8X212, Avatex 1200hc, and the aforemen- 
tioned Supra 2400. 

What it is 

If you're new to computers, you might 
not know exactly what a modem is. You 
are probably aware that they are used 
with computers and telephone lines. If 
you've read the papers, you've probably 
heard about those "hackers" who use 
modems to break into hospital, business 
and government computers, wreaking 
havoc and wrecking files. You may pic- 
ture the guys who alter phone bills, and 
wreck the financial accounts of people 
they don't like by passing around their 
credit card numbers. You may even pic- 
ture the movie Warganies, with thoughts 
of people causing or nearly causing a 
nuclear war or other disaster. 

But, as is so often the case with the 
news and media, you only hear reports 
on the misuses of such technology. It's 
true, people have caused havoc with com- 
puter and modems, but they are the 
minority. Just as a handful of homicidal 
maniacs are not indicative of the rest of 
the population of this country, people 
who use modems for mischief are not in- 
dicative of the majority of us who use 
modems for the purposes they were 
designed for. 

There are a lot of exaggerations about 
modems and the people who use them. 
These "tall tales" are based upon the mis- 
deeds of a few unscrupulous people, true, 
but they do not tell the whole story. 
Breaking into other people's systems and 
messing with their flies is not the reason 
modems were created. They were made 
to allow computers to "talk" to each other 
over conventional telephone lines, ex- 
changing data over great distances quick- 
ly and easily. 

"Modem" is an acronym for MOduIator 
DEModulator, which is a fancy way of say- 
ing the sending modem MOdulates its 
data into a carrier signal that can be sent 
over a phone line, and the modem on the 
other end DEModuIates the signal, con- 
verting it back to its original form (binary 
numbers). 

People use modems for all kinds of 
things, but the heart of it is always data 
transmission, whether that data be the 
latest stock market report, digitized pic- 
tures, or Just sending weird stories to 
friends, it all boils down to sending that 
data (or, should I say, copies of it) from 
place to place. 

Choosing a modem 

Modem's for the ST are all (thus far) ex- 
ternal, meaning they are a separate box 
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that connects to your computer rather 
than an internal card. Generally speak- 
ing, most any "generic" modem (in other 
words, one not designed for a specific sys- 
tem, like the XM301 for the Atari 8-bits) 
can be used on the ST. You needn't look 
for a modem to have "works with Atari 
ST" on its box. Any "generic" modem 
featuring an RS232 interface should work 
(be warned, however, there are always 
exceptions). 

The first thing you should look for in 
a modem for your ST is a high transmis- 
sion speed. The minimum speed modem 
you should consider buying is one capa- 
ble of running at 1200 bps/baud (bps = 
bits per second, often used interchange- 
ably with "baud"— see "A Baudy Tale" in 
the April "87 ANALOG Computing for 
more on bps/baud.) Forget any modem 
slower than that. Most ST flies and pro- 
grams are too large to be transferred at 
300 bps . . . unless you don't mind your 
computer being in transfer mode for an 
hour or more! 

2400 bps is becoming more and more 
common with ST owners, and with good 
reason. It is fast! Most people can comfort- 
ably read text being transmitted at 300 
bps, and can skim text at 1200 bps. At 
2400 bps you can only fast-scan it (unless 
you are a student of Evelj^n Wood). At 
2400 bps, I was able to scan 100 Forum 
messages in the Delphi ANALOG Atari 
SIG in just two minutes! Had 1 read them 
all I would have been there much longer. 
I merely made sure all the incoming text 
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went into my terminal program's capture 
buffer, and read the messages at my 
leisure after 1 hung up. Transferring flies 
at 2400 bps is also much less painful. 

As I stressed in "A Baudy Tale" it's a 
good idea to have a modem which fea- 
tures something of the Hayes modem 
command set (created for Hayes 
Microcomputer Products), or at least the 
Bell 212 standard (something of a subset 
of the Hayes command set). All four mod- 
ems 1 used featured this capability. (Note: 
the Avatex modem I was using was the 
1200hc, not the 1200. The he model has 
a fuller Hayes command set than the 
1200 model, and is therefore preferable— 
although both wUl work. Do not purchase 
a 12001, as it's an internal modem and 
not for the ST!) The reason for wanting 
such command set compatibility is that 
the Hayes and Bell 212 command sets are 
something of a standard in the industry, 
and most modem software will work with 
them easily. 

Now, let me quickly describe the mod- 
ems 1 used (excuse any omissions, but 1 
can't possibly discuss every modem usa- 
ble with the ST). Unless otherwise noted, 
the modems all have approximately the 
same "footprint" as an SF354 or SF314 
disk drive, and can therefore be 
"stacked" under or over them. All the 
modems feature status lights on their 
front panels, external power adapters, 
and female RS232 ports. 

Hayes Smartmodem 1 200 

As a Hayes it features full Hayes com- 
patibility, and it's well built, encased in 
a tough metal shell. You must plug a 
phone cord into the modem, but you can- 
not carry the line "thru" the modem to 
a phone. If you also need a phone on the 
same outlet, you'll need a splitter box. 
The modem can operate at bps rates from 
under 100 up to 1200. Settings can be al- 
tered with Hayes commands, and default 
settings changed by setting DIP switches 
located (inconveniently) behind the front 
panel. The power switch Is located 
around the back of the unit. 

Avatex 1200hc 

Features pretty thorough Hayes com- 
mand set compatibility. The 1200hc has 
a phone cable installed, and a plug for 
hooking your telephone "thru" the mod- 
em. The only problem with the perma- 
nently attached cable Is that you couldn't 
quickly replace it if it got damaged. Max 
speed Is 1200 bps. The modem's default 
settings can be set using DIP switches on 
the back of the unit. They can also be soft- 
set using the Hayes commands. The unit 



is encased in sturdy plastic, and features 
power, voice/data and 300/1200 bps but- 
tons on its front panel . . . quite handy. 
This modem is covered by a two-year war- 
ranty. Very nice. 

Atari SX212 

With good Hayes/Bell 212 compatibili- 
ty, the SX212 is a smart-looking unit, en- 
cased in "Atari gray" plastic and featur- 
ing diagonal status lights on the front 
panel. It can transfer data at rates of up 
to 1200 bps, and features no user altera- 
ble hardware switches. However, it can 
be programmed. The power switch Is on 
the back of the unit, annoylngly placed 
between the power cord plug and the 
modem cable. In addition to the RS232 
port, there Is also an Atari SIO port used 
for hooking the SX212 to an Atari 
8-bItter. There is no phone "thru" port. 

Supra Modem 2400 

Also with good Hayes compatibility, the 
Supra Modem 2400 features a llayes- 
esque metal case, and Is decidedly 
smaller than the other modems, which 
requires it to be at the top of a peripher- 
al "stack." The front and back panels are 
closed with black plastic, that seems a tad 
bit soft. The power switch Is on the front 
of the unit, and the back features a con- 
nector for phone line and a "thru" for a 
telephone. The modem features no DIP 
switches, but can be programmed, and, 
unlike the others, can remember your 
programmed settings even after you turn 
it off! This because it contains a static 
RAM chip that holds your own preferred 
settings (you must save them, of course). 
Top transmission speed Is 2400 bps. 

Intro to the Hayes 
command set 

The power of the Hayes command set 
is that. If your modem supports It, you 
can program the modem itself. For exam- 
ple, most modems wait about 15 to 20 se- 
conds after dialing a number to get a con- 
nection. If they don't get a connection, 
they hang up. Suppose the number you 
were dialing takes longer than this to 
respond. With many cheap modems 
there's nothing you can do, but with a 
Hayes compatible modem you can tell the 
modem how long to wait for a carrier de- 
tect (I'll explain this term later) before giv- 
ing up. This is set using one of the mod- 
em's S registers, which are programma- 
ble "switches." 

S register mmiber 7 holds the value for 
the "Tune to Walt for Ring-back/Carrier." 
Default Is usuaUy 20 or 30 units (units 
usually equal seconds). You might want 
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to make the modem wait 60 seconds be- 
fore giving up. To do this you'll need to 
put the value 60 into the S7 register. 

To let the modem know that you are 
sending a modem command, you need to 
use the "attention" command, which is 
"AT" (sans quotes). Some modems re- 
quire all such commands to be entered 
in uppercase, else they will ignore them. 
If you have a modem, turn it on, ran your 
telecommunications software, or even 
just use the Emulator desk accessory. 
When you are on the terminal (as in 
"communications terminal") screen, type 
AT and press RETURN. The modem 
should report back OK to this. If not, 
make sure the modem is on and connect- 
ed. Also, if you typed lowercase charac- 
ters, try upper case. Now, we need to use 
the attention command and tell the mod- 
em to put the value 60 into register S7. 
This is done with the command 
ATS7 = 60 [RETURN]. The modem will 
report back OK if it worked. 

To see what is currently in a modem 
register, you type the attention com- 
mand, the S register value, and a question 
mark. To see what the contents of register 
87 are you would type AT87? [RETURN], 
and the modem will report back 60 if you 
followed the previous step. 

Attention commands also precede di- 
aling instructions. The command to dial 
the phone is ATD (attention— dial.) You 
would follow this with a phone munber 
hke ATD 555-1212 [RETURN]. This tells 
the modem to dial the specified munber. 
Furthermore, you can tell the modem 
what sort of dialing to use: pulse (rotary 
dial) or touch tone. If you have a pulse 
line, you would add a P to the command, 
or a T if you have touch-tone dialing, as 
in ATDP 555-1212 or ATDT 555-1212. 

As much as the Hayes command set is 
a standard, there are still variations. For 
example, using the command ATAA on 
the Avatex 1200hc sets the modem to 
auto-answer state, where it will answer 
the phone when it rings. Using the same 
conunand on the other modems won't 
work this way, as they see it as an ATA 
command, causing the modem to go "off- 
hook." (ATA works on the 1200hc, by the 
way.) The usual way to set auto-answer on 
Hayes compatibles requires setting the 80 
register to a non-zero number — in other 
words, telling it to pick up the phone af- 
ter that number of rings. Zero (the usual 
default) means it won't answer at all, as 
in ATS0±2. 

A complete list of 8 registers, modem 
commands, what they do and how to use 
them, should appear in your modem's 
manual. 



Hook up and use 

Hooking up a modem usable with the 
8T is usually as simple as purchasing a 
cable with appropriate 25-pin R8232 seri- 
al connectors, plugging one end into the 
modem and one into the 8T's modem 
port. It also helps if you plug in the mod- 
em's power supply (the 8T's modem port 
doesn't provide power for modems) and 
plug a phone cable from the modem into 
a phone jack. 

Powering up is pretty simple. Unlike 
disk drives, which usually must be 
turned on prior to booting the computer, 
in most cases it doesn't matter when you 
turn on the modem, although some mod- 
ems seem to do better if turned on after 
the computer proper. 

Of course, the modem itself isn't of 
much use unless you have some software 
to ran on it. Telecommunications soft- 
ware is usually known as "terminal" soft- 
ware, meaning it makes your com- 
puter/modem system act like a data ter- 
minal. The software handles the job of 
controlling the modem, and sending data 
to and receiving it from the modem. 
8ome modems come packaged with such 
software, but as time goes on, less and 
less of this "bundling" is done, as the 
packaged software is rarely what the user 
needs. 

One piece of terminal software came 
with your ST when you bought it. It's the 
VT-52 terminal emulator desk accessory 
(DESK2.ACC or EMULATOR.ACC), which, 
as the name suggests, makes your com- 
puter and modem act like a VT-52 data 
terminal. This software is very limited, 
and most users And it useless because it 
completely lacks any docmnentation. The 
VT-52 emulator can be used, but be fore- 
warned that it is a terminal only. It fea- 
tures none of the niceties of a good ter- 
minal program. To dial with it you must 
issue dial commands directly to your 
modem, etc. It does not feature a capture 
buffer (where the text from your session 
is held in a buffer in RAM and/or saved 
to disk) nor can you upload or download 
files (upload means to send a file up to the 
system you are communicating with, 
download means to puU it down from the 
other system). You can type and read text, 
and that's about it. Commands for the 
emulator are Escape-key combinations 
(like pressing Escape then B). 

You're much better off buying a real 
telecommunications program, like Flash, 
Interlink 8T, or even 8T Talk Professional 
(if it's even shipped yet). Such programs 
make life much easier. They store lists of 



phone numbers that the modem can dial, 
feature capture buffers, support various 
types of data transfer (uploading and 
downloading data) and disk and printer 
support. The more powerful ones have 
capture buffers that act like mini word 
processors, letting you edit the text 
you've saved. They may also let you make 
"scripts" of commands which will allow 
your computer to automatically do cer- 
tain things. For example, such a "script" 
might be used to make your modem dial 
a mmiber, and it would then automatical- 
ly "log on," supplying the system you are 
calling with information such as your 
name, password, etc. In some cases, these 
are so powerful that they can call a sys- 
tem, log on, leave and read messages, etc., 
and hang up, all without human 
assistance! 

One of the nicest features of most ter- 
minal programs is their ability to use a 
"type ahead buffer." This buffer is usual- 
ly a single line editor, which allows you 
to type your commands, use cursor and 
other editing keys, and only send that 
line to the other system when you press 
RETURN. This is handy because editing 
text on many systems is difficult or slow, 
if not nearly impossible! Furthermore, 
you can often edit the line you just sent 
and re-send it if you goofed typing it the 
first time! 

Even better, some capture buffers allow 
you to mark certain sections of text as 
"blocks" which can be saved to disk in- 
dividually (sans the rest of the buffer con- 
tents) or even uploaded to the system you 
are connected with! You can pretype en- 
tire messages in the capture buffer, log 
on, and upload it. 

The odds of getting even 

Although the manuals for your termi- 
nal program and modem are the best me- 
ans you have for learning to use them, 
there are a number of nasty, bratish lit- 
tle details that such manuals often men- 
tion in passing that can be a major 
headache to new users if they fail to have 
certain options set properly. These "four 
horsemen" of the beginner's apocalypse 
are known as "Parity," "Duplex," "Line 
feeds," and "Block size." Terrible names 
and terrible pains if you don't know 
about them! 

Parity, if any, sets a "parity bit," an 
error-checking function used to insure 
that the data is received exactly as it was 
sent. Errors occur because of the curse 
of "line noise," that is, background dis- 
tortion on phone Unes that looks like data 
to the receiving modem. Hence the need 
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for error checking. However, parity Is 
usually set to NONE, because most good 
file transfer systems either set it them- 
selves or use their own form of error 
checking. This usually has little effect on 
the usual text and typing done in "termi- 
nal mode" (when your computer is ac- 
cessing another and you are reading text, 
etc.), because such text is usually sent 
"blind." This means that the receiving 
computer does not echo back what it 
received so that the transmitting system 
can insure it was received correctly. In 
error-checked modes, such "echoing" Is 
standard procedure. If you are having 
trouble with garbled data from a system 
you are calling, you should try changing 
the parity setting from your terminal 
program. 

Duplex sets the manner in which data 
is transmitted, either both directions at 
once (full duplex) or only one way at a 
time (half duplex.) This is difficult to 
describe, but the end result of it is that 
on full duplex, what your computer sends 
to the other computer is also echoed to 
your own screen. In this manner, you 
can see what you're typing. However, if 
the computer you're communicating 
with is also echoing the text you send 
back, you're liable to see something like 
IIIIEELLOO when you typed HELLO. On 
half duplex what you type isn't echoed, 
and, depending on what the other com- 
puter is doing, either you will see what 
you type properly, or you won't see any- 
thing at all! 

The ground rule with duplex is simple. 
If you are on half duplex and can't see 
what you type, try going to full. If you are 
on full and are seeing double characters 
for everything you send, switch to half. 
If everything looks OK, leave it alone, un- 
less there is a person on the other end 
of the connection who can't see what you 
are typing, in which case you might want 
to experiment a bit with duplex settings 
on both ends until both of you can see 
what you need to. There are also some 
echo options which can be selected In 
some terminal programs, that may allevi- 
ate difficulties changing duplex alone 
won't solve. 

Line feeds are little known by many 
users of computers, though they happen 
all the time. When you press RETURN or 
ENTER on a computer keyboard, usually 
what happens is the computer carries out 
a "carriage return/linefeed" combination. 
The carriage return moves the cursor 
back to the left margin of the screen. The 
line feed then drops the cursor down to 
the next line. Some terminals have a 



separate Line Feed key, which is used In 
combination with or in lieu of a RETURN 
or ENTER key. (Some personal computers 
have line-feed keys too, check out a 
Kaypro running CP/M for an example.) 

Your ST, modem and software are only 
"emulating" a data terminal, and do not 
feature a line feed key. Some systems 
treat the value for RETURN or ENTER as 
a carriage return only. You have to send 
a line feed character separately! For- 
tunately, most good terminal programs 
have a line feeds on/off toggle control 
somewhere. If you find that pressing 
RETURN returns your cursor to screen 
left, but doesn't go down a line, try tog- 
gling your terminal software's line feed 
option. Little is more frustrating than typ- 
ing over what you've typed before, or 
what another user is typing to you at that 
same instant! 

Block size refers to the size of a data 
"packet" sent in an error-checked trans- 
mission mode, like X modem. The size is 
usually measured In bytes. The most 
common size, used by the very common 
X modem transfer protocol, is 128 bytes 
(l/8th of a K.) It takes eight standard X 
modem blocks to make IK (kilobyte) of 
data. A modified version of X modem, 
often called Y modem, uses 1024 byte 
blocks, meaning each block sent is IK of 
data. Some computers do weird, nonstan- 
dard things. The dreaded C-64's modem 
programs often default to sending 256 
byte blocks! It's easy to get confused at 
times. For example, in Flash you can set 
the X modem protocol to 128 or 1024 
byte blocks. The latter is treated as Y 
modem, but if you forget to change this 
when you go to a system that doesn't sup- 
port 1024 byte blocks, you won't be able 
to transfer any files. If you ever find that 
you cannot seem to send or receive data 
when using a file transfer protocol like 
X modem or Y modem (there's even a 
Zniodeml) try seeing whether you can 
change the block size. (Be warned that 
some terminal programs will not allow 
you to set this!) 

On line survival 

With a modem you can call all kinds of 
computer systems, from your friend's 
own personal computer to mainframes, 
superminis, and networks like GEnle or 
Delphi. There are not too many standards 
between all these systems, so it's easy to 
get confused. Many BBS systems (bulle- 
tin boards) are dissimilar in all respects 
from one another, with no similarity in 
access, log-on, help commands, or log-off 
(hang up) procedures. Still, if you get 



stuck where you don't want, don't pan- 
ic, there are some things you can try. For 
example, the most common of all "abort" 
commands is the Control-C combination. 
In many cases, one of these alone is 
enough to blast you out of whatever 
you've stranded yourself in. In other 
cases, it takes multiple entries of this 
command. On Delphi for example, you 
can abort a file upload or download by 
rapidly pressing Control-C three times in 
a row. It's unlikely you'll accidentally hit 
such a control-key combination three 
times, so that way Delphi is sure you real- 
ly want to quit. 

Control-X and Control-Z are sometimes 
used, and may or may not help. Often, if 
you don't know where you are, what to 
do, or can't see a menu, typing a question 
mark (?) and pressing RETURN will pro- 
vide a menu. 

If you don't know how to log off of a sys- 
tem, some common commands are BYE, 
OFF, LOG or LOGOFF. "L" for "logoff 
might work from a BBS menu. You 
should always try to log off properly, not 
just hang up or turn off your modem, be- 
cause the other system might not realize 
what happened and think you are still on 
line. Some major networks can take a 
while to realize you're gone if you just 
hang up, and may still bill you for up to 
20 minutes or more of on-line time when 
you weren't there, all because you failed 
to "sign off' properly! 

In a real emergency, you can resort to 
turning off your modem, as that will 
break the connection. It's not really the 
best way to handle things, but when all 
else fails .... 

Log off 

This article, like others on so diverse 
ahd complex topics as telecommunica- 
tions, tends to be a mish-mash of Infor- 
mation. As I stated earlier, additional and 
worthwhile sources of Information are in 
any documentation you have for your 
modem or terminal software. Also, the 
aforementioned original "A Baudy 
Tale" article may also be of help. 

Allergic to all things Commodore, Maurice 
Molyneaux is an author and artist who— 
when not writing articles for ST-Log— 
continues to struggle with a recalcitrant 
eight-year-old science fiction novel, paints, 
illustrates and uses his ST for "every con- 
ceivable task." Despite a ridiculously 
French name, he claims to having been 
born in Vicenza, Italy, and denies vicious 
rumors that he eats escargot and calamari 
when computing. His Delphi username is 
MAURICEM, 
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by Ian Chadwick 

It's been a long time since I wrote 
one of these columns. ST-Log is Just out 
now and my column in it was written 
last fall, six or more months before it 
finally saw print. It's a trifle dated ... I 
can't even remember the contents of 
any subsequent columns. Well, back to 
work, then. 

Of late, I've had the opportunity to 
work with WordPerfect 4.1 and 
Microsoft Write for the ST. The former 
crashes a lot and won't always perform 
as ordered. The latter is a weak-kneed 
offering not a whit better than any- 
thing already on the market. Both are 
a lot more expensive than any of the 
competition as well. 

Both programs are the products of 
large, wealthy and important software 
publishers— WordPerfect Corp. and 
Microsoft — whose strengths in the PC 
and Mac worlds are well known. Both 
companies must be highly embar- 
rassed by these products, although for 
different reasons. 

WP appeared in late fall, 87. Four re- 
visions were shipped out by the end of 
January 88. And there are still serious 
bugs in it. The program merrily crash- 
es, performs erratically, freezes up and 
dies with disturbing frequency. It does 
not inspire confidence. 

What's the latest version? Well, at the 
time of this writing, it's January 29. 
But the versions aren 't numbered so 
you can tell what you have— they all 
say 4.1. Rely on the file creation dates 
on the disks. A "clean" version of WP 
was slated for release in late March. 
Perhaps we've all received it now. 



WP has a feature list as long as your 
arm. Very impressive, and if they all 
worked properly, it would be truly 
amazing (remember, they all do work 
on the PC). It has a super spelling 
checker and thesaurus, macro com- 
mands, on-screen column display, flex- 
ible printer control and a whole lot 
more— more than I dare list here. One 
can understand, at least, why the pro- 
gram costs so much— it offers value for 
the money. 

WP 4.1 made a big hit in the PC world 
a couple of years back. But it was 
topped by 4.2 a year ago. 4.1 for the ST 
is a close work-alike to the PC version. 
Why didn't they bring out 4.2 for the 
ST, rather than 4.1? Why did they slav- 
ishly tie the ST version to the PC, 
rather than take advantage of the ST's 
various features such as graphics? Why 
did they release a flawed version that 
should have been kept in the beta stage 
for a few more months? Good 
questions. 

This isn't typical of WordPerfect 
Corp.— they have a good reputation de- 
veloped over four years of hard work. 
Obviously the ST marketplace doesn't 
have the potential of the MS-DOS world, 
so perhaps efforts to perfect the 
product aren't quite as active as we 
would hope— after all, they also sell a 
version for the Amiga, Apple II and a 
version 5.0 for the PC is about to be 
released. All these products take time, 
effort and money. 

WordPerfect Corp. squashed 
rumours that they would pull out of the 
Atari market, due to rampant piracy. 
WP was found on at least three pirate 
BBSs, but they are still making the ef- 
fort to stay with us. That shows a seri- 
ous commitment on their part. If you 
want them to remain part of this mar- 
ket, then show them the same amount 
of respect and don't make or accept 
any pirate copies of their product. If 
they pull out, the chance of anyone else 
in their league coming over to the ST 
is slightly less than your being hit by 
Halley's comet. 

I have faith that WP will finally come 
to its own— that the bugs will be fixed 
and the program will be finished. It was 
suggested that they might release 4.2 
for the ST a year or so from now. Don't 
hold your breath— it will depend on 
sales of 4.1 to Justify the expense and 
effort. Of course, the pirates could ruin 
it for all of us . . . . 

Microsoft Write is another product al- 
together. It leaves me with no hope at 
all. The box art should have alerted 
me — it's hideous. 



Write is similar to Word 1.0 for the 
Mac, a product that, when released four 
years ago, wasn't much of a hit. Don't 
confuse Write for the ST with the ex- 
cellent program of that name bundled 
with Microsoft Windows. No hope. And 
don't think it bears any resemblance 
to the latest versions of Word on either 
the Mac or the PC. Will Microsoft up- 
grade the ST version? Add new fea- 
tures? Improve the display? Not within 
the Age of Mammals, anyway. 

Write whimpers. It does little that 
other word processors don't do at half 
the price. It looks like it's WYSIWYG, 
but aside from screen fonts, it can't 
show text as it will appear when print- 
ed. Multiple columns, for example, 
don't display across the screen. Head- 
ers, footers and footnotes don't show 
on the page where they print. There 
isn't a spelling checker or thesaurus, 
and printer drivers are limited to the 
SMM804, Atari laser and Epson- 
compatibles. The list of features is 
depressingly short and unimpressive. 

Like WP, Write copies from another 
system— the Mac in this instance. It 
does it so well that it even ignores the 
right mouse button (the Mac only has 
one mouse button . . . ). Like WP, it is 
also not the latest version the compa- 
ny has to offer everyone else. But un- 
like WP, it leaves a distinctly un- 
pleasant aftertaste. Why would anyone 
bother bringing out such a lame duck? 
And then charging top dollar for it! 
Surely Jack and the boys don't think 
we're that gullible!?! 

I heard that Microsoft washed its 
hands of the Write project early on and 
gave it to Atari to finish development 
(more than a year in the doing there- 
of). A local source even told me that 
only a single, co-op student program- 
mer was assigned to the project. Why 
doesn't that surprise me? Even if It 
isn't true, the program looks like it was 
a back-burner project. I'm surprised 
that Microsoft even allowed its name to 
be associated with the final product. It 
looks like no one was ever consulted 
on the concept of word processors and 
what the consimier might want in one. 

On the back of the Write package it 
states: "Team Microsoft Write with an 
Atari Mega computer and the Atari 
SLM804 laser printer for an excellent 
desktop publishing system." Write 
can't import or print graphics, doesn't 
do kerning, can't produce rules, won't 
display multiple columns— the sim- 
plest things required by desktop pub- 
lishing. To call this statement mislead- 
ing doesn't do it justice. I say it's an out- 
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right lie. Write is absolutely unsuited 
for desktop publishing. 

WP and Write are major software dis- 
appointments, although as 1 said earli- 
er, for different reasons. 1 had high 
hopes that these two companies- 
major dynamos in the industry and 
major competitors for the same market 
(word processing) would race to offer 
the best programs they could. Neither 
one achieved that. I'm willing to wait 
for the finished WP, but as far as I'm 
concerned. Write isn't worth the shelf 
space it consumes. 

Way back when, I wrote about the 
Atari PCI. It's been available in Cana- 
da since the end of December but 1 un- 
derstand not in the USA. The PC2 start- 
ed shipping up here in early March. 
I've been led to believe that the PC ser- 
ies is unloved and unwanted by the 
U.S. Atari folk. No one seems to care to 
see them released in the USA. Maybe 
because they're tired of flogging the 
mediocre? 

The PCI is a good idea in a handsome 
package, but poorly implemented as a 
consumer product — the design lacks 
foresight and comprehension of the 
marketplace demands. It has built-in 
monochrome, CGA and EGA graphics 
and a Microsoft compatible mouse. It 
comes with a good amber monitor but 
bundling discourages making a pur- 
chase of a color or high-res monitor 
later. The monitor port is standard 
TTL, without composite or RGB output. 
So far so good. It goes pretty much 
downhill from here. 

The PCI has a 720K 3.5" internal 
floppy drive and can accept another 
two externally. The nice thing is that 
they're standard ST314 drives. The 
nasty thing is that Atari doesn't make 
a 5.25" drive for the machine and 
there's stUI a lot of software out there 
that's not available on 3.5" disks. It also 
makes for difficult data transfer if your 
office machine uses 1.2MB floppies! 

The basic memory is 512K RAM, ex- 
pandable to 640K maximum. With no 
expansion cards, forget RAMdisks or 
additional EMS or LIM8 memory cards. 
This is a severe restriction. Many PC 
programs make use of expanded 
memory— Lotus 1-2-3 for example. 

The PCl's biggest failing is the lack 
of standard expansion slots. There is 
only a single custom bus— for which 
the schematics have not been released! 
The myriad of PC/XT cards available for 
almost every other PC aren't of any use 
with the PCI. Forget internal clock 
calendars, modems, new graphics 
drivers, additional parallel or serial 



ports, joysticks, fax cards, JLaser cards, 
RAM cards or even a hard drive. If you 
get anything, it must connect through 
the existing serial, parallel or floppy 
port. See what I mean about 
short-sightedness? 

The PC2 is a better machine but still 
a long way from perfect. It offers pret- 
ty much everything the PCI has, plus 
a bit more compatibility with the real- 
world PC market. The biggest differ- 
Both machines come with a two- 
button ST mouse (although the best PC 
mice, like Logitech's, are the three- 
button type) but no utilities to create 
menus, drivers, and so on for non- 
mouse programs (with which every PC 
mouse comes, of course), 
ence is that it can house a 20mb hard 
drive and a single 5.25" floppy or two 
floppies. 20mb, however, is a small 
drive — 1 filled 40mb on my AT clone in 
a few months! Also, you apparently 
can't mix 3.5" and 5.25" drive types to 
take advantage of both (I use one of 
each on my system). 

The PC2 has four standard expansion 
slots, which is adequate for most users. 
It doesn't have the external floppy port, 
but has the parallel, serial and mouse 
ports like the PCI. 

Both machines are extremely IBM/PC 
compatible. They are switchable be- 
tween 4.77 and 8 mhz speeds, but I 
don't know how many, if any^ wait- 
states that includes, so the realized 
speed may be less. 4.77 mhz really 
drags on the 8088, and 1 can't imagine 
why anyone with even a semblance of 
brain power would work at that slow 
a speed. Many competing XT clones 
offer lOmhz "turbo" speeds. 

The keyboard, alas, is lightweight 
and the keys appear to be cut from the 
ST mold— a trifle larger than standard 
PC size, so clumsy and awkward— as 
the ST keyboard is. However, it is 
detachable. You can replace it with a 
Keytronics or a similar keyboard. 

Both machines come with MS-DOS 
3.21, GWBASIC, GEM desktop, GEM 
Write and GEM Paint. 1 don't know 
why Atari failed to provide the latest 
version of DOS 3.3. 1 also wonder why 
the PCI rates all of this software when 
the ST limped along with an un- 
finished version of NeoChrome, third- 
rate 1ST Word, a slow and cranky BAS- 
IC and GEM without GDOS. Think 
maybe we got the nasty end of the 
stick? 

All in all, I can't recommend the PCI; 
the design is too restrictive and there 
are a lot of expandable competitors at 
the same price with a few more options 



from which to choose. It's not even 
suited as a home machine, because it 
can't be upgraded or enhanced. 
However, if you need an expensive 
paperweight. . . . 

The PC2 is a reasonable entry-level 
system for the home user. The limita- 
tions on floppy drives (number and 
type) and hard drive size certainly low- 
er it below any professional or business 
user category. But as a backup 
machine, when fully loaded, it should 
be adequate. 

Other notes 

In my next column, I'U look at an en- 
tirely new ST product— ST X* Press 
designed by Alan Page, co-author of 
Flash. Imagine being able to get all the 
news 24 hours a day— international, lo- 
cal, business, your favorite sports sto- 
ries, market updates, weather, fashion, 
and so on. Not a newspaper— they'd be 
on your ST. Instead of rummaging 
through page after page looking for sto- 
ries of interest, you could collect sto- 
ries with specific keywords and save 
them to disk to read later. That's just 
part of what ST X* Press does when 
combined with your TV cable. It does 
a whole lot more too, but I'll talk about 
it next time. A very exciting new offer- 
ing for this market. 

Desktop publishing: I haven't seen 
anything except the earliest release of 
Publishing Partner (their "profession- 
al" version is expected— one hopes a 
significant improvement over the origi- 
nal!), although I see new packages are 
out there now (Fleet Street publisher 
for one). I hope to be able to get the 
newest releases and compare them 
with Xerox's Ventura Publisher for the 
PC in the near future. 

I've played a lot of Wargame Con- 
struction Set, from SSI, recently. A 
thinking person's game— challenging 
but fun. I'll review it soon, along with 
several new products including Juggler 
from Michtron, GFA Artist, Gunship 
and Defender of the Crown. 

My thanks to readers who sent me 
PD programs (especially the GFA list- 
ings) after my disk hard crashed. I have 
since heard of others losing their data 
the same way. I appreciate everyone's 
support. 

Cheers! 

Ian Chadwick is a Toronto-based techni- 
cal writer specializing in desktop publish- 
ing. He is currently designing several war- 
games, including one for the ST. He is 
looking for reference books on Napoleon- 
ic warfare, cannpalgns, armies, etc. Con- 
tact him at: 47 Oakcrest Ave, Toronto, 
Ont., Canada, M4C 1B4. 
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Since their introduction, computers 
have been touted as omnipotent tools, 
with the power to Increase productivi- 
ty while liberating human beings from 
the tedium of repetitious tasks. The 
latest 68000-based personal computers— 
among them, the Atari ST— promise to 
bring the number-crunching strength 
of the $40,000 workstation to the com- 
mon man. All that's left is for program- 
mers to create applications that will uti- 
lize that muscle for practical, real-world 
purposes. 

One of the more powerful facets of 
computer usage these days is 
Computer-Aided Design (CAD). CAD 
software offers a way to design and 
visualize objects before money is spent 
—and perhaps wasted — on creating the 



final product. Furthermore, the capa- 
ble ST makes an inexpensive station 
for CAD duties. 

Tom Hudson's original CAD-3D has 
been enhanced and streamlined for ef- 
flciency to provide more than Just sim- 
ple three-view drawings. At the same 
time, many "bells and whistles" have 
been added to Stereo CAD-3D 2.0, 
making it even easier to design objects, 
letting the user build complex groups 
of Cy\D-3D objects through the use of 
standard camera movements (zooms 
and rotations, for example) and object 
manipulations. It also bears the distinc- 
tion of being the flrst ST product that 
requires one megabyte of RAM to 
operate. 

By far the most exciting addition is 



animation through frame-by-frame 
recording to disk (we'll discuss the de- 
tails shortly). To assist in that goal. The 
Catalog provides an animation editing 
language called Cybermate with CAD-3D 
2.0. The combined package is named 
Cyber Studio. 

The Cybermate language was created 
by Mark Kimball, who was primarily 
involved in the StereoTek project at 
Tektronix. The StereoTek glasses are a 
new approach to 3D; instead of tradi- 
tional red and green lenses, these glass- 
es contain liquid crystal shutters that 
alternately open and close in tight syn- 
chronization with the ST monitor's 
screen refresh rate. The program alter- 
nates between two different screens at 
the same rate, so fast that only a slight 
flickering is noticeable. A View-Master 
effect is achieved because each eye sees 
a separate image from a slightly differ- 
ent perspective. CAD-3D 2.0 and Cyber- 
mate both support the StereoTek glass- 
es, so entire 3D animations can be 
created. 

Put Away Your Hammer And 
Nails. . . 

Comparing the new program with its 
predecessor, CAD 2.0 (as we'll refer to 
it from here on) primarily has a refined 
user interface. The new package is 
icon-driven; anything you need can be 
achieved by sliding the mouse pointer 
to a specific icon and clicking. This 
differs from CAD 1.0 (still available by 
itself), which works entirely from drop- 
down menus. 

Beyond that, the scope of the pack- 
age is immense. For starters, one of the 
icons contains a bank of "primitives," 
basic shapes like spheres, cubes and 
wedges that can be used as building 
blocks to create more intricate shapes. 
And you can easily create your own set 
of primitives with two included 
utilities. 

The "Spin" routine is used for lath- 
ing symmetrical objects — such as a 
wine glass or light bulb— from an out- 
line. Once this "template" is complet- 
ed, clicking on the "Do spin" line from 
the drop-down menu magically carves 
out the item and places it in your view- 
ing windows. You can also do partial 
spins of whatever percentage or num- 
ber of degrees you choose, to bring 
about more Intricate shapes. 

The other object-sculpturing tool is 
the "Extrude" routine, which works 
like a hot knife to cut non-symmetrical 
pieces. Placing the points of the object's 
perimeter on the template and clicking 
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on "Do extrude" will similarly resiilt in 
a 3D object. 

These two easy-to-use routines give 
great control over the items you work 
with. Though you can use an overlaid 
grid for precision plotting, it's difficult 
to make rounded edges. You must cUck 
the mouse exactly on each point of the 
arc; freehand drawing of circles and 
arcs is close to impossible. Some com- 
panies are distributing ST-compatible 
graphics tablets that should help with 
object creation. 

A promising and less expensive alter- 
native is a separate program (current- 
ly in the works and possibly out by the 
time you read this) that will allow you 
to create CAD-3D objects from DEGAS 
picture flies. Many of the necessary 
tools for making cleaner curves and, 
more importantly, editing oddball 
shapes are Inherently designed into 
DEGAS, whereas attempting those 
tasks with either of the Spin or Extrude 
routines will likely result in a struggle. 
If this product fulfills its promise, it 
could present a library of animation 
characters— such as digitized acquisi- 
tions—and enable quality computer 
"movies." 

Stepping beyond the basics, complex 
creations can be constructed by taking 
multiple objects and combining them 
mathematically. Four interactions- 
Adding ("gluing" together). Subtracting 
(cutting the overlap of one object from 
another), And (making a separate item 
from the overlap area of two objects), 
or Stamping (to emboss a "decal" of one 
object's impression, like letters on an 
airplane wing) — can be called by the 
"Join" icon, giving you the ability to 
make intricate models from simpler. 



building block shapes. 

You're not limited to just making ob- 
jects, either. Once you've constructed 
an object, CAD 2.0 frees you to alter 
parameters that control any part of ob- 
ject viewing. The resultant images can 
be viewed in four modes— Wireframe, 
Solid, Hidden Line Removed (a combi- 
nation of Solid and Wireframe), or Solid 
Outline (a Solid shape with highlight- 
ed edges)— and even particulars like 
lighting (strength and locations) and 
coloring (both object and background) 
can be varied to suit your needs. Addi- 
tionally, you can use a DEGAS picture 
as a backdrop for further ambience and 
artistic effect. 

To view the scene as a full-screen 
depiction, a click on the "Superview" 
icon will display whatever is in the 
camera view, which can be saved to 
disk in your choice of DEGAS, NEO or 
C.O.L.R. file formats. Double-clicking 
the Superview icon brings up a dialog 
box for setting up the viewing mode 
(listed previously), in mono or stereo, 
or in draft or final version. The latter 
gives a more accurately calculated pic- 
ture, less likely to contain errors of per- 
spective. For stereo viewing, you can 
also control what percentage of devia- 
tion exists between the left and right 
images, and where the image appears 
'in" the monitor, "outside" the moni- 
tor, or "at center" (at the screen face). 

You also have your choice of four 
viewing windows: Camera, Top or Bot- 
tom, Front or Back, and Right or Left 
(with the opposite windows capable of 
being toggled with each other). Your 
viewpoint can be varied by moving the 
camera angle or zoom, and the object(s) 
can be moved within any active win- 




dow (excluding the Camera window, 
which is only for "sightseeing") by 
dragging it with the mouse. Incidental- 
ly, any window can be set to fill half the 
screen for better control over the ad- 
justment and refinement of the object. 

Additional tools are available to 
manipulate objects within the CAD 2.0 
"universe" — the cube-shaped world 
that your objects inhabit. There are 
icons for moving, rotating and sizing; 
including group or single object rota- 
tion; rotation around the universe's 
center point, a group's center point or 
user-specified point; and camera rota- 
tion and banlting. 

For any CAD program to work in a 
professional capacity, it needs to be 
able to identify scale and establish its 
accuracy. Precision scaling of objects 
is amply p-ovided for in CAD 2.0 by 
labelling one of your objects as the 
"master" and using it as a reference in 
sizing any other objects. 

Lights, Camera, Action . . . 

Now we get to the exciting part: mak- 
ing your designs come to life. It's ac- 
complished by clicking on the "film- 
strip" icon to activate the animation 
recorder, then moving the objects in 
the windows or shifting the camera 
perspective, and recording those 
changes one-by-one (by clicking on the 
record icon) to save the "frame" to disk. 
It's that simple. The final results can 
be run as a stand-alone "movie," 
without the need for the CyberStudio 
disk, by using the included public- 
domain ANIMATE2.PRG file (available 
in the Databases of Analog's ST SIG on 
Delphi). 

It's important to note that products 
like the Future Design Disk and the 
Fonts, Primitives, Hints and Tips Disk 
are being released to give users addi- 
tional components and tools for work- 
ing with CAD-3D. With expansion in 
mind, Hudson made CAD 2.0 the first 
module of a potentially larger "Cyber" 
system. 

GEM contains built-in commands 
that enable programs running on the 
ST to communicate with each other, 
using a structure called a "message 
pipe." In this way, an accessory and a 
running application may exchange 
information — in fact, it's possible for 
the accessory to take complete control 
of the application (assuming the pro- 
grams are written to work together, of 
course). This is the principle behind 
the pipeline; it allows programmers to 
write accessories that can greatly ex- 
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tend CAD-3D's capacities. To further 
this end. The Catalog has released the 
3D Developer's Disk, which contains 
several practical programming exam- 
ples of how to access the pipeline, and 
complete docimientation on all the 
message protocols supported by CAD 
2.0. 

The manuals for the 3D Developer's 
Disk and Cybermate are provided in 
the form of text files on disk that you 
must print out yourself. . .a not-too- 
minor inconvenience, since these files 
produce over 70 pages of hardcopy 
each. The files are formatted for a stan- 
dard 8 1/2" by 11" page, but you have 
to make sure your printhead is set ex- 
actly at the perforation line before you 
start printing, or the headers and foot- 
ers will be incorrectly aligned. A large 
portion of the text in the 3D De- 
veloper's Disk docimientation was pub- 
lished previously in STart magazine. 
Summer 1987. 

The CYBSMASH and PD3DCTL acces- 
sories (see below) are examples of what 
can be achieved by using the message 
pipeline. Just about every function of 
CAD-3D 2.0 can be remotely controlled; 
hopefully, programmers will begin us- 
ing this ability to add features to 
CAD-3D, like real-time machine lan- 
guage object rotation routines, or bet- 
ter compression routines for anima- 
tion files. 

The first example— and Hudson's ac- 
knowledged testbed— of this potential 
is the PD3DCTL desk accessory. It's a 
strange name for a powerful tool, but 
here's how the name breaks down: PD 
stands for Public Domain; 3D refers to 
the CAD program; CTL is an acronym 
for Control. 

To summarize, PD3DCTL (which is 
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also available in the ST SIG on Delphi) 
is a freeware taste of the forthcoming 
Cyber Control language; the aim being 
automation of the animation sequence. 
Visualizing the tedium of the above sit- 
uation (recording a frame, moving the 
objects or camera a tiny bit, recording 
the frame, etc.), you can see how benefi- 
cial it would be to have the computer 
handle those tasks. After all, as we 
mentioned at the top of the article, this 
is the strongest feature of computers. 

With PD3DCTL/Cyber Control, you 
can write a BASlC-like script file using 
a simple programming language to 
take control of CAD 2.0's desktop and 



the animation sequence. It can take 
hours to build an animation by hand; 
running things from your command 
script can save a lot of time and free 
you to do other things. It's a powerful 
tool with loops, variables and func- 
tions, resulting in an "Automated Ani- 
mation Construction Set." 

To show Cyber Control's strength, 
they've also added some features not 
programmed into CAD-3D, such as re- 
mote cameras; at present, the only 
camera in CAD 2.0 is always facing the 
center of the CAD universe, a hin- 
drance to certain effects in an anima- 
tion. The remote camera could be 
placed anywhere in the CAD 2.0 
"universe," flying around and even 
through objects. 

The Cybermate Language. 

Included in every CAD 2.0 package is 
Cybermate, an "object-oriented" 
programming language very similar to 
Forth (in fact, supposedly based on MT 
Forth), which gives you the ability to 
manipulate the "delta" animation files 
created by CAD 2.0. "Delta Compres- 
sion" is the data-compaction scheme 
used by CAD 2.0 to keep the size of ani- 
mation files within manageable limits 
by saving only the frame-to-frame 
changes, instead of saving an entire 
32K screen for each animation frame. 

Cybermate allows you to control and 
alter many aspects of these delta files 
—cutting frames in and out of se- 
quences (similar to "sphcing" film or 
video tape), stepping through an anima- 
tion sequence, changing its speed or 
screen location, setting loop points, 
chaining to other delta files (to get 
around memory limitations and allow 
much larger animation sequences), 
pixel-by-pixel dissolves from one 
"scene" to the next, and more. Cyber- 
mate also allows you to include flies 
generated by The Catalog's G.I.S.T. 
sound editor program, to spice up your 
mini-movies with appropriate sound 
effects. 

The Forth Connection. 

Cybermate's familial relationship 
with Forth is both a strength and a 
weakness. Although Forth has many 
advocates, a case could be made that it 
is not the easiest or most intuitive lan- 
guage for people to learn. As in Forth, 
all Cybermate math operations are per- 
formed using Reverse Polish Notation; 
to add two and three the Cybermate 
statement would be "2 3 -f- ," not the 
way most people are accustomed to 
thinking about math. Cybermate pro- 
grams are organized into one or more 
16-line "screens," another Forth con- 
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vention. To edit "Cybercode," you must 
load each screen individually, edit the 
text it contains, and save it to disk be- 
fore editing another screen; you can 
have only one screen's worth of code 
in memory at any one time. This proce- 
dure is rather clumsy, especially for 
casual programmers accustomed to the 
ftiU-screen editors used by most im- 
plementations of BASIC. We strongly 
suggest the use of a RAM disk or a hard 
disk while editing Cybercode— 
otherwise the constant disk accesses 
will have you in the rubber room in 
short order. 

On the other hand. Forth is general- 
ly recognized as a good language for 
motion control applications, which 
makes it particularly well-suited for 
animation editing on the ST. The 
"screen" editing concept (although in- 
convenient at times) has the advantage 
of freeing up lots of memory for anima- 
tion objects, which are usually quite 
large. Forth is a "user-extensible" lan- 
guage; this means that you can develop 
routines (called "words") for general 
purposes and actually make them part 
of the language— like adding your own 
commands. Also, since Forth/ 
Cybermate is a compiled language, it's 
possible to produce a .PRG (or "run- 
time") version of an animation that can 
be run as a stand-alone file, without the 
need for Cybermate or any special dis- 
play program. 

The Cybermate language system has 
four primary modes of operation: Inter- 
preter, Text Editor, Preview Editor, and 
Display. Interpreter mode acts much 
like BASIC'S "direct" mode. You can 
type in any legal Cybermate command 
and it will be acted upon immediately. 
Text edit mode lets you create and edit 
screens of Cybercode, which will com- 
prise your animation program. The 
Text Editor has many word processor- 
like features, including cut-and-paste 
and Insert/Replace text entry modes. 
The Preview Editor displays your ani- 
mation frame-by-frame, showing you 
the current time values and color set- 
tings and allowing you to alter them. 
Preview Edit mode is useful for deter- 
mining exact timing of animation se- 
quences, without having to edit a 
screen and re-compile it. Display mode 
is entered when you "run" a Cyber- 
mate program. 

Cybermate is referred to as "object- 
oriented" because of the way it handles 
animation data, files; when a file is load- 
ed, Cybermate creates an internal 
structure called an "object" using the 
data in that file. You give each object 
a unique name, and refer to the object 
by that name for all programming/edit- 
ing operations. Objects can be of three 



basic types: sound effect files produced 
by G.I.S.T., uncompressed picture files 
created by the DEGAS paint program, 
or sequence flies created by CAD 2.0's 
record function. Once an object is de- 
fined in this way, it can be "cloned" to 
make a copy for working purposes. 
These are the main building blocks of 
a Cybermate animation. 

Like most computer languages, 
Cybermate has variables, looping struc- 
tures, and data areas. A typical Cyber- 
mate program might display the first 
frame of an animation sequence, then 
enter a "TICK/TOCK" loop, which 
would update the screen image accord- 
ing to Cybermate's internal clock. The 
clock regulating the execution of a 



bly the "forth programmer's Bible"). 
The manual does contain a well-written 
tutorial that walks you through the 
main functions of Cybermate, using 3D 
objects which you create when you go 
through the main CAD 2.0 tutorial. 

The Cyber-verdict. 

Cybermate works well as a whole, 
although a few annoying quirks are evi- 
dent. You must be in low resolution to 
run Cybermate. . .yet, the program 
starts up with a medium resolution 
80-column text screen. Since the pro- 
gram obviously handles resolution 
changes Itself anyway, why not let the 
user load Cybermate in either resolu- 
tion? At the time of this writing, there 



TICK/TOCK loop can be adjusted to any 
value, to achieve faster or slower ani- 
mation speeds. A TICK/TOCK loop Is 
similar to a FOR/NEXT loop in BASIC; 
all code between the TICK and TOCK 
statements Is executed at regular Inter- 
vals, until the last frame in a sequence 
is detected or the loop Is exited by 
other means. 

Cybermate also supports some tradi- 
tional Forth looping structures, like 
DO/LOOP, and BEGIN/UNTIMIEPEAT, 
and decisional structures like IF/THEN. 
A full range of logical and bitwise oper- 
ators Is available for Integer math 
functions. 

If you have no experience with Forth, 
be prepared to spend a good deal of 
time puzzling over the Cybercode ex- 
amples contained in the CAD-3D pack- 
age. At the end of the Cybermate manu- 
al is a short appendix titled "Generic 
Forth" which will help a little bit, but 
the manual Is not Intended to teach 
Forth. Instead, It recommends several 
books devoted to this purpose, includ- 
ing Starting Forth by Leo Brodie (argua- 



Is no support for monochrome, even 
though CAD 2.0 can generate 
monochrome DELTA files. (Note: Ac- 
cording to Catalog Marketing Director 
Gary Yost, monochrome monitor sup- 
port Is planned for Cybermate, and a 
version that works in monochrome 
may even be released by the time you 
read this.) Also, the interpreter mode's 
keyboard input has an odd, somewhat 
disconcerting feature; the backspace 
key does not delete characters, it just 
moves the cursor backwards, leaving 
the text intact. 

It's Important to note that Cybermate 
Is probably not for everyone. Indeed, 
the manual states that "Cybermate Is 
NOT the place to start in the Cyber Stu- 
dio system." A comprehensive under- 
standing of CAD 2.0 Is essential before 
you can begin to tackle Cybermate; and 
even then you've got some work ahead 
of you. A background In some sort of 
programming will definitely help; a 
background in Forth would be even 
better. However, If you make the effort 
to climb Cybermate's rather steep 
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STPlus»STPlus»STPlus»STPlus 

P.O. 1197, Berkeley, Ca. 94701 

We all want the ST to grow, so let's BUY MORE SOFTWARE and discourage 



BUSINESS 



DBMan 4.0 175.00 

Datamanager 66.00 

Superbase 104.95 

Trimbase 69.95 

Phaser 63.95 

Zoomracks 2 84.95 

Base 2 42.95 

The Informer 69.95 

WordPerfect 189.95 

1st Word Plus 69.95 

Word Upl 74.96 

Best Accounting 279.95 

Equal Hus 139.95 

Inventory Mgr. 69.95 

Rolobase Plus 63.95 

Loglstlx Spread 104.95 

MIcrolawyer 49.95 

Payroll Master 69.95 

Construction EST. 35.00 

Microsoft Write 94.95 

Datatrieve 35.00 

STOneWrtte 48.95 

VIP GEM 104.95 

DacEasy Payroll 48.00 

DacEasy Acctg 62.00 

WordWrtterST 56.00 

SwIftCalc 56.00 

EZ Calc by Royal 48.95 

Analyze Spread 25.95 

Final Word 99.95 

PubllshlngPartner 140.00 

T-works Publish It 89.95 

EZData Base 48.95 

Chart Pak 35.00 
Compute Roots 
Thunder NEWI 
Hobawrtter 2 
Text Pro 
Becker Text 
Expert Opinion Al 
Time Link 
Partner ST 
Labelmaster Elite 
ST Accounts 
The Juggler 
Max Pack 
Stuff 
Flash 1.5 
SBTacctIng ea. 
Omni Res 
Turbo ST(~blltter) 
Dollars & Sense 



GliAPHlCS 



Degas Elite 55.96 

CAD 3D 2.0 63.95 

Cyber Paint 49.00 

Quantum 4096 27.95 

Adv Art Studio 26.00 

Spectrum 512 49.00 

EzDraw&Superch 104.96 

Canon Scanner 1040.0 

GFA Artist lOOOcI 65.96 

Draflx 1 139.95 

Athena 2 69.96 



GAMES 



Gunship 

Shadowgate 

Uninvited 

Mouse Quest 

Slaygon 

Barbarian 

Obllterator 

Guantlet 

Dark Castle 

F- 16 Strike Eagle 

Star Trek- Rebel U. 



How would you like to be an 

ST dealer? If you are 
interested, I am looking for a 
few limited partners to work 
with in areas which lack ST 

support. This is not a 
solicitation by Atari nor to 
circumvent Atari's network 
but an invitation to work with 
an established dealer to set 
up new dealerships. I am 
especially interested in college 

and business areas. 
Call (415)841-9183 to discuss 



PROGRAMMING 



GFA Basic 
GFA Book 
27.96 GFA Compiler 
28.96 Mark Williams "C" 
48.95 Laser "C" 
35.00 Cambridge Lisp 
62.95 RAID 

59.95 Fast Editor 
35.00 Alice Pascal 

48.96 OSS Pascal 
36.00 Fortran 77 GEM 
149.00 BCPL 
36.00 Modulo 2 dev. kit 
36.00 Assempro 
27.95 Fast Basic 

True Basic 



48.95 
35.00 



GAMES 



21.00 
276.00 
27.95 
35.00 
69.96 



EDUCAJIONA 



Arokls Series 
Unicom Series 
True Basic Stuff 



Tanglewood 
^ - Test Drive 
JZ^rf Chessmastr2000 
StarGllderbw&cl 
Hunt for Red Oct 
Police Quest 
Allants 
Allen Fire 
Santa Paravia 
Lurking Horror 
Star Fleet 1 
Empire 
•00c Llesure Suit Larry 
Gridiron 

Dungeon Master 
Flight Simulator 
Trallblazer 
••SPECIALS •••• 

Jewel of Darknss 



MUSIC 



35.00 (Passport 
35.00 Master Tracks 
35.00 MasterTracks Jr. 
14.00 MIdlsoft Studio 
27-95 ^yhidJirts 
il'nt Smpte Track 
27.95 Sync Track 
35.00 EZ Track Plus 
27-95 MIdlscore 
27-95 EZ Score Plus 
27.95 DX-Androld 
CZ-Androld 
Gen- Patch 
D-50 Editor 
Voice Masters 
Yamaha TX81Z 
Roland AJ 1 & 2 
Yam tia 21,27,100 
Oasis Editor 
Hybriswitch 
ADAP Smptecue 
upgrade old box 
MIDI- MAZE 
ADAP 2 direct to 
60mghd sampler 
MIdlplexer 
2)r. Ti 

KCSequencer 
KCS l,6w/PVG 
MIDI rec studio 
NEW Copyist 
CfUetafi Midi Inst. 



27.96 



MK5 Keyboard 



159.95 
139.95 
27.95 
36.00 
69.95 
59.95 
139.95 
104.95 
104,95 



66.95 
69.95 



35 00 MK6 II 
32-95 MK5 V 
32-95 MK7VA 

OA ok ^^"^ 

ii nn Interfacer 
35-00 Synth Module 
?; 00 SMPTE to MIDI 
27-95 DX Heaven editr 

?o of •^^'O' KawaLetc 
39-95 cz Patch editor 
27-95 cz patches 
35.00 DX patche s 



280.00 
104.95 
69.95 

499.95 
299.95 
48.96 
call 
104.95 
139.95 
69.95 
104.95 
call 

69.96 
69.95 
55.96 

175.95 
21.95 

175.95 
70.00 
27.95 

2796.0 

249.95 

199.96 
289.96 
27.95 
139.96 

249.96 
399.95 
549.96 
794.96 
339.95 
369.95 
119.95 
534.96 
349.95 
104.96 
call 
79.96 
39.95 
39.95 



14.00 
27-35 

69-95P silicon Dr^ri^s" 

^e'iM^AS?WliS£?U £^^^1^^"^ ^InlfJ^^ J415)849-8717 Prices subject to change without notice, 
we Ship ANYWHERE! $4.00 mln S&H. No 1040 s or Megas mall order. Hand deUvery orSy. Ust plus $100 

CIRCLE #115 ON READER SERVICE CARD. 



27 20 meg hard disk 

30 meg 
,9 95 60 meg 
19 95 Atari CD-ROM 



568.95 
749.95 
1249.95 
499.95 



learning curve, you'll find yourself in 
possession of a very impressive set of 
animation editing tools. 

The Wrap-up. 

This package is typically Hudson- 
esque— our term for the type of 
carefully-written, easily-worked soft- 
ware for which Tom is well-known. If 
the communications pipeline is im- 
aginatively exploited, we may see Atari 
ST computers gaining more respect. 



Microbyte Floppy Disk Drive 

Paradox Enterprises, Inc. 
Version A, 360K Nth $235 
Version B, 1.2MB Nth $245 
by Matthew J.W. Ratcliff 

The Microbyte 5-1/4-inch floppy disk 
drive for the Atari ST is an extremely 
useful device to own— if you need one. 
If you have an IBM at work, or a PC at 
home, you'll probably want, if not 
need, this drive. (I tested the 360K ver- 
sion for this review.) 

We know ST cannot run IBM pro- 
grams (at least, not without an emula- 
tor), so what use is this drive? Let me 
give you a few examples. If you use 
Generic CADD at work, you might like 
to bring your designs home and use 
First CADD on those same files. (These 
programs don't use the same format, 
but are written by the same software 
house. The ST version of First CADD 
comes with a utility for performing the 
necessary conversions). A similar argu- 
ment holds true for Lotus and VIP 
Professional, which are file compatible. 

Moreover, if you write a lot, it's al- 
ways convenient to be able to easily 
move text files between the two 
machines. I occasionally develop code 
for work at home, and vice versa (on 
my lunch breaks or course), so I've real- 
ly had a chance to put the Microbyte 
through its paces. Currently, 5-1/4-inch 
floppies cost about one-fourth as much 
as the 3-1/2-inch diskettes, so the 
Microbyte is handy for archiving a lot 
of flies economically. 

The drive comes in a sturdy metal 
case (color matched to the ST system), 
and is a half-height mechanism, just 
like the current crop of DS/DD drives 
found in IBM PC XT compatibles. This 
unit employs the same power supply 
as Atari's 8-bit 1050 disk drive: a sim- 
ple 9-volt AC output transformer (easi- 
ly replaced). 

Of course, it's as simple to hook up 
as any other ST drive. The interface ca- 
ble is hard-wired into the drive, with a 
male connector for the computer or 
the other drive at the opposite end. 



There's no output connector on this 
unit. This means that the Microbyte is 
drive B if you have a two-drive system. 
If you wish to use it as drive A, you can- 
not have a second floppy on the ST. 

The connector is a bit oversized. 
Although I had no problem daisy 
chaining it to my old SF354 Atari drive, 
when I upgraded to the newer SF314, 
I found it very difficult to get the Micro- 
byte connector to stay in place. Care- 
ful arrangement of the cables solved 
the problem. 

Once the drive is hooked up to the 
ST, the busy light comes on and stays 
on while the computer is booting. 
When the system is up, and all is well 
with the Microbyte, the busy light pul- 
sates dimly, like a heart beat, to let you 
know everything's A-okay with the 
unit. 

Two programs come with the drive. 
The Paradox program must run from 
an auto folder at boot time, which sets 
a different step rate for the Microbyte 
drive. The head access time is slower 
for a 5-1/4-inch unit than than the 
3-1/2-inch floppies normally used. If 
the step rate is not set properly, you'll 
get constant read and write errors. 

The second program is a format util- 
ity, used to perform a double-sided, 
double-density 360K format of the 
5-1/4-inch drive. (The 360K formatting 
we normally do is for a single-sided 
3-1/2-inch unit; it just won't work for 
a 5-1/4-inch drive.) The biggest problem 
with this formatting utility is that disks 
prepared with it cannot be read on an 
IBM PC or compatible. This is frustrat- 
ing because you must format all your 
5-1/4-inch disks on the PC, if porting 
files is your primary goal. (A disk for- 
matted on the PC can be read and writ- 
ten on either computer.) 

The formatting program provided by 
Paradox writes all zeros to the empty 
sectors, as does the GEM format utili- 
ty. However, the IBM expects to see the 
following bytes (this information 
courtesy of Joe Pierce, Delphi user- 
name JOEPIERCE), in the first four po- 
sitions of track zero, sector zero: 

PS7 FT6 $EB, $2C, $90, $49 

If those bytes are not there, the IBM 
assimies the disk is blank, or damaged. 
When Joe gave me this data, I took an 
ST formatted 5-1/4-inch disk to work 
and used a disk editor to write those 
bytes out there. After the modification, 
the IBM no longer thought the disk was 
blank, but could read and write to the 
disk with no problems. 

Paradox definitely needs to update its 
formatter with this information. I 



would prefer an accessory version of 
the format utility, so a 5-1/4-inch disk 
can be formatted from a desktop menu, 
like the 3-1/2-inch disks. 

Because of the unique format of a 
5-1/4-inch disk, none of the hard drive 
backup utUities will work with the 
Microbyte, which, of course, is one of 
the uses I had planned for it. I have 
been archiving some valuable folders 
from the hard drive "by file" to the 
5-1/4-inch disks with no problems, 
however. A hard drive backup utility, 
specifically written for the Microbyte 
drive, would certainly be useful. 

One particular annoyance you will 
encounter with this drive is that the 
power switch is at the rear, making it 
difficult to access if you have a com- 
puter hutch or similar setup. You will 
also find it necessa/y to shut it off from 
time to time with certain commercial 
software. Some programs (World 
Championship Karate, for instance) de- 
tect the presence of a second drive. If 
they find one, they automatically ex- 
pect a data disk to be there. 

After several months of daily use, I've 
found the Microbyte to be a quiet, fast 
and reliable little workhorse. It comes 
in handy for proting files and making 
inexpensive backups of my files, and 
most important, keeping the clutter off 
my hard drive. 

The hard disk drive 
HD-i^ ASTRA SYSTEMS 

by David Plotkin 

The HD-^ from Astra Systems is a 
combination 20-megabyte hard-disk 
drive and double-sided floppy, all pack- 
aged in a box no larger than other hard 
drives. It's ideal for 1040 owners, or 
those looking to upgrade one-drive 
systems. 

The HD -I- comes preformatted into 
two 10-megabyte partitions, and can be 
used within minutes of unpacking. The 
ST's operating system cannot recog- 
nize disk drives larger than 16 mega- 
bytes, therefore you're unable to use 
the whole 20-megabyte drive as a sin- 
gle logical drive. What you do, instead, 
is split the single physical drive into 
two logical drives (such as "C" and "D"). 

The hard drive includes an extra-long 
cable for connecting the built-in flop- 
py drive, allowing you to place the 
HD -I- farther away from your ST than 
would normally be possible. There's a 
"floppy in" connection, but no "floppy 
out" connection, so the floppy drive in 
the HD -H must be the last one in the 
chain (drive B in a two-drive system). 

Software includes a formatting pro- 
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gram (to reformat the disk and/or 
change the partition size), a backup 
program, a head parking program, and 
the hard drive install program. The 
backup program uses a special fast for- 
mat and puts close to a megabyte of 
data on a double-sided disk. It can copy 
files which are larger than a floppy and 
do partial backups. The head park pro- 
gram allows you to lock the head in 
place before moving the drive. Always 
do this! The hard drive install program 
is placed in an AUTO folder on the boot- 
up disk and enables the ST to recognize 
the hard drive. Currently, all programs 
you want executed on boot-up (hard 
drive install, clock, GDOS, etc.) must be 
in the AUTO folder on the boot-up 
floppy. 

Desk accessories may be either on 
the floppy or on the hard drive itself. 
Astra doesn't supply a hard drive auto- 
boot program, although 1 don't see why 
the Supra version wouldn't work. I ha- 
ven't tested this, however. 

The HD-i- is solid and built like a 
tank. The hard drive mechanism is a 
top-of- 

the-line Ffodime, and the floppy is of 
high quality as well— Panasonic or Chi- 
non, depending on the vintage. The 
front panel features an on/off switch, 
hard drive light and floppy light. The 
hard drive unit must be turned on to 
use the floppy, even if you boot up 
without the hard drive instaU program 
(the hard drive won't be avaUable if you 
do this, however). The unit is relative- 
ly quiet for a hard drive, the low hum 
of the fan being the most notable 
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sound. 

Once you're tried a hard drive, you'll 
never go back. The increase in speed 
is astounding. For example, Word- 
Writer ST takes close to 30 seconds to 
load from floppy, but only six seconds 
from the hard drive. The speed de- 
pends on how full the disk is and how 
much your files are fragmented, but is 
always significant, nonetheless. You'll 
have to be careful about buying copy- 
protected software however, since most 
of it cannot be installed on a hard drive. 
1 solved this problem by refusing to 
buy such software. Fortunately, the 
best packages are not protected. 

The HD-^ is relatively expensive, 
selling for between $850 and $950. 
This is more expensive than the Atari 
hard drive and a double-sided floppy 
(SF-314), but there are compensating 
factors. The first is that the unit is 
much more compact than two separate 
pieces of equipment. The second is that 
SF-314S are scarce, so you may not be 
able to find one. Finally, the Astra units 
are top quality. 

I'm not saying Atari's equipment is 
second rate, but my own experience 
has been disappointing, especially with 
the disk drives, and I don't like to take 
chances with my valuable programs 
and data. 

With high speed mechanical equip- 
ment (hard drives spin at 3600 rpm), 
the two old adages, "You get what you 
pay for" and "Let the buyer beware," 
are especially true. The Astra HD -i- is 
fast, well built and extremely reliable. 
In my book, that makes it a bargain. 



TACKLE BOX from SRM Enterprises 

P.O. Box 40 

USAFA, CO. 80840 

(303) 472-6624 

Atari 520/1040/Mega ST 

by David Plotkin 

Tackle Box (TB) "A UtUity for Tack- 
ling Personal Pascal" is a package of 
software and information which 
should be of use to anyone hoping to 
program their ST. It includes informa- 
tion on the VDI, AES, the operating sys- 
tem, a variety of technical subjects, and 
most of the hardware chips which 
make up the ST computers. It comes 
complete with software libraries (in- 
cluding a math library) which wiU 
make programming easier, and it's also 
probably the most clearly written and 
least error-ridden source of informa- 
tion about the ST. 

Personal Pascal is a product of OSS. 
The language arrived on the scene ap- 
proximately a year and a half ago, and 
is the programming language of choice 
for many people, especially those who 
are not technically inclined. The 
popularity of the language stemmed at 
least in part because of the better-than- 
average explanations of how to use the 
implements of GEM (windows, mouse, 
menus, dialog boxes, etc.) in your pro- 
grams. Quite a few GEM commands are 
directly supported from Personal Pas- 
cal. For example, it is, to my 
knowledge, the only language which al- 
lows you to build dialog boxes from 
within the program itself. 
Many GEM and operating system 
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commands are not present as key- 
words in the language, and these must 
be accessed by using generic system 

calls, such as the VDI CALL and 

AES CALL commands. You must set 

up your program to use such generic 
calls by including a variety of custom 
TYPES in your declarations and also 
declaring a multitude of EXTERNAL 
Functions and Procedures to access 
them. You must also have a source of 
information on how to use the calls, 
since the Personal Pascal manual does 
not provide any information on them. 

Enter Tackle Box. This monumental 
package (it is over 900 pages of infor- 
mation, measuring almost three inches 
thick) provides just about everything 
you need to access the functions of the 
BIOS, XBIOS, GEMDOS, VDI, and AES. 

First, we'll talk about the documen- 
tation. The first pages detail exactly 
how to use TB. You have two choices. 
First, you can use the generic Pascal 
calls. Certain files from the TB software 
libraries need to be included when you 
compile your program, but the libraries 
provide all the custom TYPES. This op- 
tion is a little messy since the generic 
calls are long and full of numbers and 
arrays which must be initialized. The 
second choice is to use calls identical 
to those used in C. These are shorter 
and more self-explanatory. They are 
also much cleaner, since you general- 
ly don't need to deal with the arrays 
like INTIN and PTSIN; these are han- 
dled automatically by the C calls. Fur- 
ther, you can benefit from the large 
amount of other literature which has 
been written about using C in various 
peridicals and books. To use the C-style 
calls, you need to include some of the 
TB libraries as well as link some ".O" 
files provided on the disk. The source 
code for these .0 files is also provided, 
so that you can modify them to remove 
Functions and Procedures you aren't 
using (this shortens the final object 
code size). 

The documentation continues with 
sections on GEMDOS, BIOS, XBIOS, VDI 
and AES. Each section is conveniently 
tabbed and includes a section table-of- 
contents to make information easier to 
find. Sections start out with a well- 
written introduction explaining what 
the referenced part of the system soft- 
ware is for and how it operates. Final- 
ly, each command is documented on 
its own page. This includes: 

1) Number of the call (for use with 
generic Pascal commands). 



2) KEY— the name to use if you opt for 
C-style commands. 

3) Type of the call (Function or 
Procedure). 

4) If a function, the type of the 
returned value (integer, etc). 

5) Purpose— what the call is used for. 

6) Method— An explanation of all 
parameters which are passed to the call 
with their names or location in arrays 
and all parameters which are returned. 

7) Restrictions— any warnings about 
what to look out for when using the 
call. 

8) Implementation— an example of the 
call. 

9) Example— a sample problem and 
the program code you would use to 
solve it. 

How much would you pay . . . 

The documentation is liberally illus- 
trated with samples where words can't 
handle the descriptions— polymarker 
types, patterns, etc. Even a helpful pic- 
ture of the various raster blit modes is 
included. Further, where a call dupli- 
cates a function or procedure already 
built into Personal Pascal, the manual 
notes this and recommends you use 
the built-in version. 

But wait, there's more . . . 

Then there's the math library. If 
you've read many Personal Pascal list- 
ings, you know that certain useful 
things are missing. Many trigonomet- 
ric and transcendental math functions 
are not provided, nor is there any easy 
way to convert numbers to strings (for 
use with DRAWSTRING) and back. The 
math library section of TB provides all 
this and more. Sines, cosines, hyper- 
bolic functions, logarithims, powers 
and decimal degree to DMS conversion 
are all provided. It has base conver- 
sions (binary, octlal, hex and decimal) 
which are a godsend to the program- 
mer. It also has a battery of sound com- 
mands. These make using sound fair- 
ly simple, since you can directly speci- 
fy the sound register (there are three 
available), note, octave and volume, and 
turn the noise on and off. The math 
library also includes its own functions 
to get and set the date and time which 
are much easier to use than perform- 
ing bit-twiddling on the numbers you 
get from GEM. Finally, there are the 
functions which return the addresses 
of arrays, screens, and MFDBs. There 
is even a function to convert a Pascal 
string to a C-type string, which is 
necessary to use the C-type calls in the 



libraries. 

Now how much would you pay? 

If you are "into" hardware, the next 
section of TB will be welcome. It has 78 
pages describing the layout and func- 
tioning of the hardware, followed by 
the actual technical manuals of many 
of the chips, including the 68000, the 
sound chip, the floppy controller, 
GLUE, MMU, DMA and SHIFTER. This 
is pretty technical and is definitely not 
light reading, but having all this infor- 
mation in one place is very useful. 

At no extra charge . . . 

The final two sections are titled "Pas- 
cal tutorial" and "Tackle kit." These 
consist of a mixed bag of tutorials and 
sample programs. A complete descrip- 
tion of disk layout and file handles 
works in conjunction with a desk ac- 
cessory program that makes all kinds 
of disk operations available from any 
GEM program. Now you can format 
disks, copy disks, move files and other 
disk operations, This is a nice bonus, 
since you would normally have to pay 
for a program like this. 

Other tutorials include color anima- 
tion, loading picture files, screen swap- 
ping, a section on MIDI, a joystick sam- 
pling routine and even a whole section 
on GDOS. This last is the best descrip- 
tion I have seen on the intricacies of 
this subject. The sample programs in- 
clude your own copy of GDOS (courte- 
sy of Atari), a GDOS font editor with 
source files, numerous samples of 
GDOS fonts, and hints on how to use 
the font editor to create fonts for GDOS 
programs like Easy-Draw (from 
Migraph). 

To top it all off, the manual even in- 
cludes a glossary, reference guide and 
index. 

I have only a few minor complaints 
about Tackle Box. The manual is pep- 
pered with minor typographical errors. 
These primarily fall into the category 
of variable declarations which don't 
match the program examples, and mis- 
pellings, which can easily be spotted by 
even the novice Pascal Programmer. I 
suppose in a work of this size, a few ty- 
pos are to be expected! The sample pro- 
grams are provided on two disks in 
ARCed form, and you must deARC 
them, which is something of a pain. 
And some parts of the manual are 
difficult to understand because they as- 
sume the user knows too much. This 
is especially true of the highly techni- 
cal calls, such as reading the intelligent 



94 



July 1988 ST-Leg 



keyboard. 

NOW How much would 
you pay? 

Tackle Box is a remarkably useful 
work which belongs on the shelf of any 
programmer, even if they don't use 
Pascal. It is worth its price just for the 
clear, concise documentation, with the 
software libraries being an added bo- 
nus for the Pascal user. Captain Rusty 
MulUns, U.S.A.F., president of SRM en- 
terprises, has really produced a superi- 
or product. Once you have seen it, you 
will agree with me— it's the package 
Atari should have provided with the 
ST. 

Circuit Malcer 

Illiad Software 
Review by Frank Cohen 

It is 4 a.m. Your university level, digi- 
tal electronic-design class will be hold- 
ing its final exam in the morning and 
your term project is due today. You 
might wonder why your eye's are 
bloodshot and your fingertips have 
bum marks. It's probably because 
you've been up all night working on a 
"breadboard" to make an integrated 
circuit do something simple. 

Breadboards were created years ago 
as a temporary way to design and test 
simple electrical circuits. A breadboard 
looks like a bunch of Lego building 
blocks and is covered with places to 
snap and couple wires: Integrated Cir- 
cuits (ICS), Light Emitting Diodes (LED), 
and switches. An electrical engineer 
usually starts with the design of an 
electrical circuit on paper. To test the 
design, the individual components of 
the circuit are assembled and placed 
onto the breadboard. A power supply 
is connected to the breadboard and the 
circuit is tested. If the circuit fails to 
work properly, the breadboard compo- 
nents can be easily shufQed around un- 
til the circuit begins to work. 

Circuit Malcer makes the breadboard 
a thing of beauty. Instead of using 
physical components. Circuit Maker 
displays the breadboard and all the pos- 
sible components on your Atari ST's 
screen. Only a few clicks of the mouse 
are needed to make a connection be- 
tween an IC and an LED. Selecting the 
RUN command from a drop-down 
menu simulates the circuit while it is 
running and the LED will become illu- 
minated. VoUa! Instant electronics, just 
add water! 
Circuit Maker is a "simulation" pro- 



gram. It falls into the category of Com- 
puter Aided Design (CAD) and Com- 
puter Aided Manufacturing (CAM) soft- 
ware systems. CAD/CAM software simu- 
lates the physical world as lines and 
drawings on your ST's screen. Normal- 
ly, commands are given to a CAD/CAM 
program using the mouse. The pro- 
gram's ability to accurately manipulate 
and display the simulation is what de- 
termines a good program from a bad 
program. Circuit Maker simulates most 
of the commonly used electronic com- 
ponents in a very friendly and intuitive 
manner. 

Circuit Maker is packaged in a sim- 
ple, unadorned user manual. A regis- 
tration card is included so that you 
may receive the planned upgrades 
directly from the manufacturer. Illiad 
Software offers one free upgrade to 
registered users. After that, backups 
and upgrades cost $10 each. 

The manual covers enough informa- 
tion for you to run the program and 
understand each of the program's func- 
tions, and also includes several experi- 
ments in a tutorial section that require 
a minimal amount of electronics ex- 
perience. However, for those of you 
with Uttle or no electronics experience, 
the manual is not a book on digital elec- 
tronic's design. For that, you will have 
to find an introductory book or more 
likely take a course on the subject. 

For experienced electronic designers 
or students. Circuit Maker is a power- 
ful way to create, test and record digi- 
tal electronic designs. While a circuit 
is running, software oscilloscopes may 
be attached anywhere in the circuit to 
view logic levels of any component or 
wire. The dynamic ability to test cir- 
cuits is very impressive. 

The user of Circuit Maker has a large 
library of electronic Components to 
use. Common NAND and NOR gates, 
flip-flops, gates, seven segment 
decoders and displays, LED's, digital 
timers and oscillators, and switches are 
available for circuit design. Wires and 
connect points are used to connect any 
of the available circuits. Once connect- 
ed, the RUN command makes the cir- 
cuit live and any of the output devices 
(LEDS and Seven Segment Displays) 
show the performance of the compo- 
nents as the circuit performs its 
designed task. 

Circuit Maker uses GDOS, so what ap- 
pears on the screen may also be print- 
ed out. GDOS is the controversial GEM 
operating system enhancement that al- 
lows fonts and graphics to be shown on 



the screen and printed on a laser 
printer, plotter or normal dot matrix 
printer. 

Illiad Software purchased a limited 
license to use GDOS from Atari for a 
$500 fee. Michael Newson, Illiad Soft- 
ware's Marketing Director, indicated 
that Circuit Maker uses version 1.8 of 
GDOS and comes with a printer driver 
that will print only on Epson graphics 
printers. Newson said several other 
printer drivers might become available 
in the near future. 

Circuit Maker was written in the 
Modula 2 programming language. At 
times, it can be cumbersome to oper- 
ate as simple mouse clicks and other 
graphic functions have long lag times. 
Circuit Maker is fairly memory effi- 
cient, however a one-megabyte system 
is needed to hold a realistic number of 
components in a circuit. 

Illiad Software also markets a com- 
plete CAD package called Athena. Ex- 
pected early next year, Athena 2 
Professional will also have CAM func- 
tions to drive tooling and manufactur- 
ing machines capable of receiving com- 
puter commands. In its Utopian state, 
the designs developed in Circuit Mak- 
er will be sent to an "auto routing" pro- 
gram which will determine the exact 
component layout of your design. Athe- 
na 2 will be used to produce the final 
PC Board design and program a mill- 
ing machine to produce the finished, 
printed circuit board. 

Circuit Maker was designed by Ozzie 
Boeshans, an electronics designer at 
Signetics, one of the largest integrated 
component manufacturers. 
Bureaucracy 
by Douglas Adams, et al 
INFOCOM 

125 Cambridge Park Drive 
Cambridge, MA 02140 
(617)0576-3190 
ST Disk $39.95 

by Andy Eddy 

Everyone, at one point in their life 
or another, faces the "red tape shuf- 
fle," the hideous condition that comes 
from dealing with big companies and 
their infernally inefficient ways of do- 
ing things. Proof of this malady shows 
up regularly; blood-boiling examples 
include having a phone conversation 
put on hold for a matter of weeks or 
getting the runaround while trjang to 
straighten out a $1 million computer 
error— obviously not in your favor- 
on your bank account. 

Douglas Adams— best known for 
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bringing his twisted, yet realistic, 
sense of humor to light on the radio, 
on television, and later via computer 
disk in the Hitchhiker 's Guide To The 
Galaxy— and Infocom have taken 
true-to-life horrors like these and 
turned them into a warped adventure 
that is called, fittingly enough, 
Bureaucracy. 

The scene is set (based on an actual 
experience that Adams went 
through): You have just moved into a 
new house, as well as acquired a new 
position in a new company. As if deal- 
ing with all that isn't enough, your lo- 
cal bank has misplaced your change- 
of-address form. So what, you say? 
Well, the bank has sent your newly 
renewed, valid credit card to your old 
address and you're supposed to be on 
your way to a working vacation in 
Paris. As you quickly find out, noth- 
ing seems to go your way . . . NOTH- 
ING! Needless to say, you're up 
against a wall— a bare wall, as the 
moving company has yet to deliver 
your furniture from your old resi- 
dence. See what I mean? 

Bureaucracy is much like your 
standard text adventure; you have to 
find items and their uses to help you 
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in your quest, and certain goals have 
point values. The difference here is 
that your progress isn't predominant- 
ly monitored by the number of moves 
you make or your score— after all, 
how could you score in a life ex- 
perience Uke this? 

Realistically, you'll know how you're 
faring by way of an on-screen blood- 
pressure reading. Everything that goes 
wrong causes your blood pressure to 
rise; aggravating bank tellers sending 
you to closed windows, liUing out form 
after confusing form, phoning your 
girlfriendA)oyfriend to find that 
they're no longer interested in you, 
even by using words that the game's 
parser doesn't imderstand (though the 
game sarcastically tells you that you 
aren't Ucensed or authorized to use 
that word). 

It gets you right in the mood from 
the start. The first thing you're told 
when you boot up is that you aren't 
licensed to operate the software, but 
through their kindness you can fill 
out an on-screen form to straighten 
out the predicament. You're shown a 
form, and one by one you're prompt- 
ed to fill in the entries— albeit in a 
random order that sets you off 



balance— and certain slots bring 
about a snide comment from the 
game on your answer. Then it pro- 
ceeds to mangle the information any- 
way; getting your house number 
wrong, calling you Ms. instead of Mr., 
and on and on. 

Bringing the chase into more realis- 
tic ambience. Bureaucracy takes the 
initial form you filled out and tailors 
the rest of the contest so it closely 
parallels your life, creating a type of 
Computer Mad-Libs, if you wUl. Your 
entries become the focal point of the 
story— the bank is located a couple of 
doors from your house address, your 
present and past girlAioyfriend's 
names are listed in your phone book 
and they later leave disheartening 
mesages on your answering machine, 
someone will invariably walk by car- 
rying something shaded in your least 
favorite color. 

Best of all is the whimsically 
sardonic feel to each and every situa- 
tion you're up against. Meandering 
through your neighborhood is like a 
trip to the looney bin, as you meet the 
strangest group of people and animals 
that you could possibly Imagine. Door- 
front intercoms spewing forth the 
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weirdest banter, a deaf matron with 
an elephant gun, a one-winged macaw 
whose cage is lined with something 
you'd like to get your hands on. And 
that's just for starters. 

You'll laugh and chuckle with every- 
thing the game throws your way, but 
frankly, it gets under your skin after 
a whUe because you can relate to what 
is going on in real terms. This goes be- 
yond the typically wonderful Infocom 
style, because Bureaucracy uses your 
name, speaks to you directly and teUs 
you, point-blank, what a mess your Ufe 
is becoming! Why shouldn't you feel 
edgy and apprehensive laughing about 
your life going down the tubes— even 
if it is a game? 

Bureaucracy is a wild romp through 
corporate affairs and its interaction 
on the hapless, helpless "little guy." 
Send a copy of it to a bank manager 
near you and then go hide your 
money in your mattress. Besides hav- 
ing a lesson for big companies in 
there somewhere, it can be entertain- 
ing to us peons as well. 

SupraModem 2400 

Supra Corporation 

1133 Commercial Way 

Albany, OR 97321 

(503) 967-9075 

by Andy Eddy 

All Atari Computers $219.95 

It wasn't that long ago that we 
reviewed Supra and QMI's 1200 baud 
modems. In that article, we noted that 
modems have really dropped in price 
as their speed has increased; now that 
statement seems even more applicable. 
It appears that 300 baud is now passe, 
1200 baud is more or less the new stan- 
dard and 2400 is on its way to giving 
1200 a battle for the top spot. 

Helping out in that respect is the in- 
expensive SupraModem 2400. For Atari 
owners, there are actually two models. 
The unit for the ST comes with Supra's 
own Omega terminal software, and the 
modem can actually be used on many 
computers, as the ST utilizes standard 
IBM cables for hook-up. The 8-bit 
telecomm crowd gets the same modem, 
but the package includes the fine, pub- 
lic domain terminal program. Express 
(with a version of the documentation 
Supra has cooked up). 

To connect the modem up to the cus- 
tom ports on the 8-bit line. Supra also 
adds in a 13-pin Serial I/O, direct- 
connect interface. This allows you to 
daisy-chain it to your other compatible 
peripherals and avoid the added ex- 
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pense of another interface unit, such 
as ICD's P:R: Connection or Atari's 850. 
For this review, we used the ST version, 
but the modem itself is exactly the 
same in both configurations, so no per- 
formance differences should be 
noticed. 

The first realization you get after tak- 
ing the modem out of the box is its 
diminutive appearance. It measures 1" 
by 4«/8" by eVa"— not much bigger than 
two cigarette packs placed side-by- 
side— and looks to be about half the size 

Thankfully 
missing from 
Supra ^s 
docs are 
misspellings 
and awkward 
phrases that 
generally 
accompany 
this Godzilla 
school of 
technical 
writing. 

of most standard modems. Size has 
nothing to do with ability though, as 
the SupraModem is still equipped with 
many of the indicators and functions 
of other modems: 8 LEDs that update 
the status of High Speed operation. 
Auto Answer enabling. Carrier Detect, 
Off-Hook condition, Data Reception and 
Transmission, and Terminal and Mod- 
em Readiness; an internal speaker; ftdl- 
featured dialing capability for Touch- 
Tone and Pulse; user-definable, yet 
non-volatile, RAM memory for storing 
of various data such as an often-used 
phone number, type of dialing, speak- 



er volume and more; and most impor- 
tantly, Hayes-compatibility. 

The last feature is one of the most 
powerful aspects of telecomputing. 
From that you can set up the perfor- 
mance of the modem for criteria such 
as how many rings before modem 
picks up the line, the amount of time 
it waits for a dial tone before it starts 
dialing a number, the status of the 
speaker and its volume, even activation 
of certain internal diagnostic tests. 

These abilities provide you with 
major league telecomputing muscle, 
but that also brings with it the poten- 
tial for confusion and difficulty in 
learning. Luckily, Supra has coupled 
the hardware with a decent manual 
that details how to handle the configu- 
ration of the modem. The other benefit 
of this is the lack of DIP switches any- 
where on the modem; it's all taken care 
of through these internal registers. 

This alone puts the SupraModem 
2400 head and shoulders above some 
of the other 2400 modems I've seen re- 
cently. The other problem I've had with 
competing modems, whose manuals 
usually come from the other side of the 
world and are then translated into En- 
glish, is the nearly-unreadable quality 
of documentation— especially given the 
frequently intense subject matter. 
Thankfully missing from Supra's docs 
are misspellings and awkward phrases 
that generally accompany this Godzil- 
la school of technical writing. 

Actually hooking up the SupraMo- 
dem is simplicity as well. As tiny as it 
is, all you have exposed are two modu- 
lar phone jacks (one for the incoming 
phone line and the other to connect to 
a phone), an RS-232 connector passing 
data between the computer and the 
modem and a small socket for the pow- 
er transformer cable. The front panel 
only contains the eight previously- 
noted LEDs and a click-on/click-off 
power switch. 

You have to give the Supra folks a lot 
of credit for as compact and well 
designed a product as they've come up 
with— which is their own design, as op- 
posed to their self-labeled Avatex 1200. 
Modem hook-up is simple, operation 
takes very little getting used to and the 
price is an incredible value, a trendset- 
ter, to say the least. 

The only hitch I've found is the mod- 
em's dropping a connection when the 
computer is shut off' or reset. There are 
some times that the program you are 
running may crash, and losing the 
link-up can be somewhat annoying. 
Sometimes this brings with it an ER- 
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ROR message on the next time you try 
to dial or use any AT (to get the mod- 
ems ATtention) command. A call to 
Supra brought a lack of awareness of 
the problems (though this has been 
confirmed by one other SupraModem 
2400 user, in their defense it could be 
a problem limited to some of the first 
units off the production line), but they 
promised to look into it and get back 
to me. This follows along with the stan- 
dard of support they've provided over 
the years. 

All told, the SupraModem is a fantastic 
deal. For only $219.95— though IVe heard 
it's been sold in some stores for aroimd 
$150— you can't find a more enticing bar- 
^in. Once again. Supra challenges the 
marketplace and gives Atari users the 
next stepping-stone. 

Buzzword 

by Paul Granchelli, Carl &c Warren 

Strobel, <&; friends 

The Buzzword Game Company 

P.O. Box 440747 

Aurora, Colo 80044 

512K Disk $39.95 

It was almost a year ago that I took 
a look at the 8-bit version of this pro- 
gram. 1 found it to be a refreshingly 
new and original word game, one 
which could be enjoyed by all mem- 
bers of the family. However, the only 



problem was that not every Atari fami- 
ly could get involved. This has been 
rectified with the arrival of the ST ver- 
sion of this game. 

Buzzword is a word game, plain 
and simple. There are no fancy graph- 
ics, no plunges into outer space. After 
selecting a catagory (which is chosen 
from one of the 200 pre-printed cards 
supplied with the game), players take 
turns guessing words, given the first 
letter of the word, the number of let- 
ters in the word, and a pool of letters 
still unused. Points are awarded for 
correct guesses, deducted for errors. 
Three levels, from Bright to Gifted, al- 
low all players to compete evenly. But 
if this were the extent of the complexi- 
ty of this game, it would quickly be 
shelved. Fortunately, Buzzword has 
enough variety to keep your disk drive 
humming for months to come. 

Each category contains up to 50 
different answers. Since only nine are 
used at any one time, chosen random- 
ly with partial dependence on the lev- 
el of play each time a category is chos- 
en, you can play many times without 
learning the answers. Each category 
has been assigned a replayability fac- 
tor as a guide to the number of times 
it can safely be repeated. And the 
categories and answers are numerous 
and diverse enough to interest and 
challenge everyone. From parlor games 



to candy bars to Indian tribes, the 
cards test knowledge in hundreds of 
areas. A special category. Buzzword 
connection, challenges you to supply 
words which naturally follow a given 
word, such as "red." Answers in this 
case might be "red carpet" (easy) and 
"red shift" (hard). 

Four basic options combine to create 
32 different games. First, singles or 
doubles can compete. Then, hints may 
be limited to only the first letter or only 
the length of the answer, or, for the 
truly brave, no clues whatsoever. The 
number of letters in the available let- 
ter pool can be displayed or hidden, 
and a time limit to guess a word can be 
imposed. But even with all these op- 
tions, game play is simple. After boot- 
ing up, you simply select a card, a play 
level, and the desired options, and then 
you begin typing in words. Your only 
problem will be misspelled words and 
typos. Thus it is desirable to place your 
best typist and speller at the keyboard. 

The game has preserved the screen 
display used in the 8-bit version with 
little enhancement, other than the fact 
that the resolution is somewhat great- 
er. The top right corner of the screen 
contains the current card, displaying 
the category and clues, if any. Below 
that is the letter pool and to the upper 
left is the scoring area. The bottom left 
of the display holds a typewriter on 
which you type your answers. 

Documentation consists of a game 
manual, ST loading instructions, and 
two decks of game cards. The manual's 
24 pages are fully indexed and com- 
pletely describe game play, while han- 
dy charts summarize the 32 play op- 
tions and the 200 catagories. The decks 
of playing cards, however, seemed un- 
necessary and tended to slow play and 
make it less challenging. Indeed, in 
testing both the 8-bit and ST versions 
we have never used the cards exten- 
sively, and they seem inspired by the 
cards used in Trivial Pursuit. However, 
for those who like the cards, they are 
well printed and sturdy and provide 
helpful clues, and, when used as sug- 
gested in the manual, create even more 
variations on the game. 

Overall, Buzzword is an original and 
fun game. It can be played alone or 
with an unlimited number of people 
with equal enjoyment, and every mem- 
ber of the family (ages ten to adult) can 
compete. Whether considered as an en- 
tertaining diversion, or as a vocabulary 
building tool, all owners of Buzzword 
will find themselves to be winners. 
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REVOLUTIONARY 
NEW PRODUCT 



• Imagine Saving almost any game at any point, ttien being 
able to return there as many times as you like. 

• Imagine the Ultimate Back-up Utility that actually UNPROTECTS 
programs as it copies them. Lets protected programs be 
stored as tiles, run from a hard disk or even be transmitted 
over a modem. 

• Imagine saving three or more protected single sided disks on 
just one double sided disk. 

• Imagine Instantly s\Mtching back and forth between two 
different programs, games, utilities or business applications. 

Now Stop Imagining and get Switch/Back. 
It can do all this and more. 
Switch/Back Is a revolutionary new hardware and software 
package that lets you get more from your ST MUCH MORE. 

Switch/Backs gaming features lets you instantly save most games 
then continue playing. If you get in trouble you can switch back 
to where you were as many times as you like. 




REQUIRES at 

least 1 meg. of RAM 

(or a Megadlsk or Pdydlsk Cartridge) 



BACK-UPS -Switch/Back can work with your favorite back-up 
program and allow you to save whole protected disks to files for 
archival purposes. It can also automatically unprotect a 
program and save it as standard file. This method works on 
hundreds of ST programs and it allows you to run the tiles directly 
Its perfect for running protected programs off a hard disk. It 
creates standard TOS files, that con be stored together on disks 
or even transferred by modem. 

SWAP - Switch back lets you load just about any two programs 
into your ST and switch instantly between them. It works with 
games, business programs, utilities, compilers, etc. Although only 
one program is running at a time, the other is available instantly 
right where you left off. 

The Switch/Back hardware plugs into your printer port for easy 
use (It has a pass through connection for your printer too.) 

Switch/Back requires at least One Meg of memory 

(Or a Polydisk or Megadlsk) ONLY $69.95 



ST Protection Techniques 

Finally ST Copy protection techniques ore reveoled. 
This complete book and disk package details ttie state 
of ttie art in ST Protection mettiods and much, much 
mote. 

The Software included witti ttie book provides many 
powerful features like the AUTOIVIATIC PROGRAM 
PROTECTOR. This easy to use Utility allows you to protect 
iust about any ST program. Vbu can choose a 
combination of protection methods like encryption, 
checking custom disk formats, password proleclion or 
a limited use option that makes the program self- 
destruct after running a preset number of times. 
The book includes topics such as Phreaking, Logic Bombs, Hardware 
data keys, the legal aspects of piracy and software protection. Custom 
disk formats. Pirate Bulletin boards and much more. 

In addition it contains reviews of the popular ST back-up programs and 
detailed explanations of ST disks and drives. a •» ^ 

ST Protection Techniques (Book and disk package) only S39.95 




The worlds most inexpensive clock 
cartridge. Finally its affordable to 
keep your time and date accurate. 
3 year battery included. ONLY $24.95 



/ / in-rrurno'i' 



ST 



MEGADISK Ultra high speed solid state disk drive • 500% 

Faster than a Hard Disk • Provides almost instant booting • tike a RAM disk 
that's always loaded with your favorite programs and ready to use • One 
megabyte of Solid State storage • Built in battery back-up in case of 
power failures 

Ii/IEGADISK is actually one megabyte of RAM that simply plugs into your 
cartridge port. It acts as an added disk drive that's ultra fast and always 
ready for use. Like a Hard disk, MEGADISK won't loose its memory when 
your computer is turned off. It comes with its own power supply and 
bottery back-up system so its independent of your computer 

Megadlsk can be configured occording to your needs. • Set it up as 
one large disk • An 800K double sided disk and a 200K hardware print 
buffer • Or as two 400K single sided disks and a print buffer 

Megadlsk will work fine with your current system whether you have a 
hard disk and two drives or you're just getting started. 

Megadlsk is perfect for those who want the high speed of a hard disk 
for a lower price. Its even better for power users or software developers 
who may already own a hard disk and two drives but want extra speed 
and power. Megadlsk can also emulate other cartridges for testing and 
back-up. In addition Megadlsk can be used with Switch/Back to allow you 
to instantly jump between two full size one meg ^OOO OK* 

applications. '"'3 

Price Subject to change 
Megadlsk Clock Option - Adds a Clock/calendar card to your Megadlsk 
cartridge. Contains replaceable Three year battery 29.95 

Polydisk Polydisk is a 512K version of a Megadisk. Polydisk gives 
you the same fast boot features, the high speed access, and the print 
spooler. Polydisk has a power supply (like Megadisk) but does not contain 
a battery back-up. 

Note; Those with only 512K of main memory can use Switch/Back with a 
Polydisk, just like those with one Meg. 

Polydisk (512K Solid state drive) Only $199.95 

(Clock option card is also available for Polydisk $29.95) 
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COLOR COA/iPUTEREYES" 
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Incredible COLOR video digitizer. • The first and only full color digitizer 
for the ST • Uses standard video inputs like video camera, VCR, or video 
disk. • V\/orks in all ST resolutions. Low res provides 16 shade block and 
white or full color pictures. • Pictures can be used with Degas. 
Neochrome, Powerprint and others. • Automatic calibration of contrast, 
brightness and white balance. • Plugs into cartridge port for easy set-up. 
• Capture your picture or that of your favorite star. ONLY $199.95 
SPECIAL OFFER - Buy both Computereyes and Powerprint and SAVE 20.00 
from the total. 



^^"Pi^t^V Y ^"-^^ YOURSELF UP 

Imagine your picture on a 6 foot poster Create a business graph that 
can cover a wall. Quality output for posters, t-shirts, news letters, and more. 
POWERPRINT 

Whether it's a photo digitized with ComputerEyes, a masterpiece 
created with Degas, or the winning screen from your favorite game, 
POWERPRINT can print it with unequaled clarit/ and resolution, PowerPrint 
supports ALL ST resolutions, it prints multiple sizes up to GIANT WALL SIZED 
POSTERS. Print 16 shades for incredible detail. Print the whole screen or 
ZOOM in on just the part you want. POWERPRINT offers unique effects, 
including rotate, mirror and inverse options. Selective shading option 
allows you to print multi-color pictures on any printer by printing one color 
of a time (using color ribbons). Powerprint lets you capture and print 
almost any ST screen. Works with Star, NEC. Citoh, Gemini, EPSON, XM8048 
and compatible printers. ONLY $39.95 
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High Quality sound digitizer for the ST This powerful 
hardware and software package lets you sample real world sounds and 
play them back on any Atari ST Add special effects like Echo. Reverse, 
looping, pitch manipulation, mixing and envelope control. Turns your Atari 
keyboard into a musical instrument to ploy songs with your digitized 
sounds (also works with any MIDI keyboard). Digisound makes it simple to 
odd sound to your own program, too! Unleash the Incredible sounds in 
your ST with DIGISOUND. Supports sampling from 5 to 40Khz, DIGISOUND Is 
the choice of the professionals. DIGISOUND was used to create the voice 
in Chessmaster 2000, and other commercial programs. ^ nn qj- 

DIGISOUND ONLY vOV-VO 

DIGISOUND PROFESSIONAL 

All the excellent features of DIGISOUND plus these great extras 

LOGARITHMIC SAMPLING - Special hardware extends the sound qualit/ 

for above the other ST sound digitizers. Logarithmic sampling and 

playback (external amplifiers only) greatly extends the dynamic range 

while reducing distortion and noise. 

Internal Real Time Mixing - Input from o stereo and a microphone so 

you can sing over a tape. ^^^^ 95 

DIGIPLAYER The High powered digisound software can now be 
obtained by those who already own a digitizer for the ST Compatible all 
cartridge based digitizers. Extend the power of your digitizer with 
Digiplayer. . 

Only $49.95 




24 HOUR HOTLINE - VISA & MasterCard Welcome 

216-374-7469 

Customer Service line (216) 467-5665. Call or write 
for free catalog. 



Order by phone or ser)d check or money order to: 
ALPHA SYSTEMS 1012 Skyland. Macedonia. OH 44056 

Include $3.00 shp, & hdlg. (US & Canada). Ohio 
residents add 5Vp% sales lax. Foreign orders add S8.00 
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WordPerfect in Every Way 



If you're looking for software that takes full advantage of your 
Atari's capabilities while providing an extensive range of features, 
look no further. 

WordPerfect offers the power you need with features like Col- 
umns, Indexing, Merge, Macros, Speller, and Thesaurus. You'll 
find them useful for everything from simple memos to complex 
reports. All features are easily accessed using the Atari mouse 
and pull-down menus, or WordPerfect's standard keystrokes. 

WordPerfect's GEM-based design taps the Atari's resources with 
ready access to desktop accessories, full color adjustment for 
color monitors, a definable mouse pointer and cursor, and the 
ability to move and size up to four windows. And WordPerfect 
is written in assembly language to take full advantage of the 
Atari's speed. 



WordPerfect Corporation offers Atari users the stability of a 
proven product, produced by a reliable leader in software man- 
ufacturing. With full documentation, toll-free customer support, 
and free software upgrades, your investment will be profitable 
for years to come. 

Expand your options with WordPerfect - the most powerfiil word 
processor you can buy for the Atari ST. For a demonstration, 
contact your local dealer. 



WbrdFferfect 

CORPORATION 

1555 N. Technology Way • Orem, UT 84057 

Tel: (801) 225-5000 ■ Telex: 820618 • FAX: (801) 227-4288 

WordPerfect is a registered trademark of WordPerfect Corporation. All other products and brand 
names are registered trademarks or trademarks of their respective companies. 
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